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`

Static Badge GitHub top language GitHub last commit License: MIT

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

Comando	Descrição
`bun run start`	Inicia servidor via stdio
`bun run start:http`	Inicia servidor HTTP/SSE na porta 3000
`bun run test`	Executa testes

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

URI	Descrição
`self://profile/markdown`	Self completo em Markdown
`self://profile/json`	Self completo em JSON
`self://foundations`	Valores e identidade
`self://intentions`	O que te move
`self://missions`	Missões de longo prazo
`self://goals`	Metas anuais
`self://projects`	Projetos ativos
`self://obstacles`	Obstáculos e estratégias
`self://daily`	Registro diário

Tools

Tool	Descrição
`set_foundation`	Adicionar valor/anti-valor/identidade
`add_intention`	Adicionar problema/curiosidade/etc
`add_mission`	Criar missão de longo prazo
`add_goal`	Criar meta anual
`add_project`	Criar projeto
`add_obstacle`	Registrar obstáculo
`add_daily`	Registrar vitória/aprendizado/desvio
`export_markdown`	Gerar arquivo self.md

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 LICENSE para detalhes.