ciro-maciel/self-mcp

Self MCP Server

Servidor MCP (Model Context Protocol) que permite que assistentes de IA (Claude, Cursor, etc.) interajam com seu Self — um framework de autoconhecimento que conecta suas ações diárias ao que realmente te move.

Self MCP

Self Saiba por que você faz o que faz.

Instalação • Estrutura • Configuração • Uso • Resources • Tools

Requisitos

• Bun (runtime JavaScript)

Instalação

bun install

Estrutura do Projeto

self-mcp/
├── src/                    # Código fonte
│   ├── core.js             # Lógica compartilhada do MCP
│   ├── servers/
│   │   ├── stdio.js        # Servidor stdio (local)
│   │   └── http.js         # Servidor HTTP/SSE (remoto)
│   ├── db/
│   │   ├── index.js        # Módulo de banco de dados
│   │   └── schema.sql      # Schema SQLite
│   ├── lib/
│   │   └── markdown.js     # Gerador de Markdown
│   ├── tools/              # Tools do MCP
│   ├── resources/          # Resources do MCP
│   └── prompts/            # Prompts do MCP
├── tests/                  # Testes
├── data/                   # Dados de runtime (ignorado no git)
└── assets/                 # Recursos estáticos

Scripts

Configuração

Adicione ao arquivo de configuração do seu cliente MCP:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "self": {
      "command": "bun",
      "args": ["run", "/caminho/para/self-mcp/src/servers/stdio.js"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "self": {
      "command": "bun",
      "args": ["run", "/caminho/para/self-mcp/src/servers/stdio.js"]
    }
  }
}

Servidor HTTP/SSE

Para uso remoto, execute:

bun run start:http

Endpoints disponíveis:

• GET /health - Health check
• GET /sse - Abre conexão SSE
• POST /mcp - Envia mensagens JSON-RPC

Uso

Após configurar, você pode usar os seguintes prompts:

• "Quero criar meu Self" — A IA usará o prompt create_self para te guiar
• "Check-in da manhã" — A IA usará daily_guardian com modo morning
• "Como foi meu dia" — A IA usará daily_guardian com modo evening
• "Estou perdido" — A IA usará daily_guardian com modo reconnect

Resources

Tools

Como Contribuir

Abra uma Issue com suas ideias, sugestões ou experiências.

Criado por

Ciro Cesar Maciel

Licença

MIT License - veja o arquivo para detalhes.