# 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`

![Static Badge](https://img.shields.io/badge/mission-know%20why%20you%20do%20what%20you%20do-brightgreen)
<br />
![GitHub top language](https://img.shields.io/github/languages/top/ciro-maciel/self-mcp)
![GitHub last commit](https://img.shields.io/github/last-commit/ciro-maciel/self-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](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.