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.

<div align="center">

<img src="assets/logo.svg" alt="Self" width="256" height="256">

Self MCP

<br />

<p class="align center"> <h4><code>Self</code> Saiba por que você faz o que faz.</h4> </p>

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

</div>

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.