# Self MCP Server
Servidor [MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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 />
[](https://opensource.org/licenses/MIT)
<p class="align center">
<h4><code>Self</code> Saiba por que você faz o que faz.</h4>
</p>
[Instalação](#instalação) • [Estrutura](#estrutura-do-projeto) • [Configuração](#configuração) • [Uso](#uso) • [Resources](#resources) • [Tools](#tools)
</div>
## Requisitos
- [Bun](https://bun.sh) (runtime JavaScript)
## Instalação
```bash
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`):
```json
{
"mcpServers": {
"self": {
"command": "bun",
"args": ["run", "/caminho/para/self-mcp/src/servers/stdio.js"]
}
}
}
```
**Cursor** (`.cursor/mcp.json`):
```json
{
"mcpServers": {
"self": {
"command": "bun",
"args": ["run", "/caminho/para/self-mcp/src/servers/stdio.js"]
}
}
}
```
### Servidor HTTP/SSE
Para uso remoto, execute:
```bash
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](https://github.com/ciro-maciel/self-mcp/issues) com suas ideias, sugestões ou experiências.
### Criado por
[Ciro Cesar Maciel](https://github.com/ciro-maciel)
## Licença
MIT License - veja o arquivo [LICENSE](LICENSE) para detalhes.
