Metadata-Version: 2.4
Name: yabadoo-mcp
Version: 0.3.0
Summary: MCP Server para o Yabadoo — segundo cérebro pessoal conectado ao Claude
Project-URL: Homepage, https://yabadoo.io
Project-URL: Repository, https://github.com/HENRIQUE4345/yabadoo-brain
Author-email: Yabadoo <contato@pique.digital>
License: MIT
License-File: LICENSE
Keywords: ai,claude,mcp,second-brain,yabadoo
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.0
Provides-Extra: test
Requires-Dist: pytest-asyncio>=0.23; extra == 'test'
Requires-Dist: pytest>=8.0; extra == 'test'
Description-Content-Type: text/markdown

# yabadoo-mcp

MCP Server oficial do [Yabadoo](https://yabadoo.io) — conecta o Claude ao seu segundo cérebro pessoal.

## O que é?

Com este plugin, o Claude passa a ter acesso direto ao seu cérebro no Yabadoo:

- **Busca memórias** — encontra documentos, notas, decisões e memórias pelo conteúdo
- **Explora o grafo** — vê as conexões Zettelkasten entre seus temas e projetos (aceita nome legível)
- **Consulta entidades** — dossiê de pessoas, empresas e projetos (fatos, linha do tempo, relações)
- **Busca por relação** — pares de entidades ligados por um vínculo ("quem é sócio de quem?")
- **Lê action items** — acessa suas tarefas pendentes e em andamento
- **Cria tarefas** — registra novos action items direto pelo Claude
- **Vê lembretes** — consulta agendamentos e automações ativas
- **Captura pensamentos** — envia notas e ideias para o Brain Agent processar e armazenar
- **Lê o diário** — acessa as entradas recentes do seu diário pessoal
- **Consulta o inbox** — lista capturas brutas ainda não processadas (WhatsApp, web, desktop)

## Instalação

```bash
pip install yabadoo-mcp
# ou, sem instalar:
uvx yabadoo-mcp
```

## Configuração

### 1. Gere uma API Key

Acesse **[yabadoo.io](https://yabadoo.io) → Settings → API Keys → Gerar nova key**.

Copie a chave gerada (ela só é exibida uma vez).

### 2. Configure o Claude Desktop

Edite `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "yabadoo": {
      "command": "uvx",
      "args": ["yabadoo-mcp"],
      "env": {
        "YABADOO_API_URL": "https://api.yabadoo.io",
        "YABADOO_API_KEY": "sk-yaba-sua-chave-aqui"
      }
    }
  }
}
```

Após salvar, reinicie o Claude Desktop. As tools do Yabadoo aparecerão automaticamente.

### 3. Configure o Claude Code (CLI)

```bash
claude mcp add yabadoo \
  --env YABADOO_API_URL=https://api.yabadoo.io \
  --env YABADOO_API_KEY=sk-yaba-sua-chave-aqui \
  -- uvx yabadoo-mcp
```

Ou adicione ao `.mcp.json` do projeto (compartilhável via git):

```json
{
  "mcpServers": {
    "yabadoo": {
      "command": "uvx",
      "args": ["yabadoo-mcp"],
      "env": {
        "YABADOO_API_URL": "https://api.yabadoo.io",
        "YABADOO_API_KEY": "sk-yaba-sua-chave-aqui"
      }
    }
  }
}
```

## Modo remoto (Claude.ai web)

Para usar via Claude.ai, prefira o servidor SSE oficial embutido na API do
Yabadoo (não precisa rodar nada local). Se ainda assim quiser expor este
pacote via HTTP:

```bash
YABADOO_API_KEY=sk-yaba-... yabadoo-mcp --http --port 8001
```

> **Atenção:** o modo HTTP **não tem autenticação própria** — qualquer pessoa
> que alcance a porta opera o seu cérebro com a API key configurada. O servidor
> binda em `127.0.0.1` por padrão; só use `--host 0.0.0.0` (ou um túnel
> público) atrás de uma camada de autenticação sua.

Depois adicione `http://localhost:8001/sse` em **Claude.ai → Settings → Integrations**.

## Tools disponíveis

| Tool | O que faz |
|------|-----------|
| `buscar_memorias` | Busca cross-layer: docs, memórias, action items e grafo |
| `buscar_grafo` | Conexões Zettelkasten a partir de termo, título, tag ou node_key |
| `consultar_entidade` | Dossiê de pessoa/empresa/projeto: fatos + timeline + relações |
| `consultar_eventos` | Reuniões/eventos por período ISO e/ou tema, com participantes e doc de origem |
| `buscar_por_relacao` | Pares de entidades por verbo de relação (sócio, mentor...) |
| `listar_action_items` | Tarefas por status (pendente/em_andamento/concluido) |
| `criar_action_item` | Cria nova tarefa com prioridade e data |
| `listar_lembretes` | Agendamentos e automações ativas |
| `capturar_pensamento` | Envia mensagem ao Brain Agent para processar (suporta session_id para follow-up) |
| `buscar_diario` | Entradas recentes do diário pessoal |
| `buscar_inbox` | Capturas brutas (não processadas) filtrando por status, canal, tipo ou conteúdo |

## Variáveis de ambiente

| Variável | Descrição | Padrão |
|----------|-----------|--------|
| `YABADOO_API_KEY` | Sua API key (obrigatório) | — |
| `YABADOO_API_URL` | URL da API | `http://localhost:8000` |
| `YABADOO_API_TIMEOUT` | Override global do timeout HTTP, em segundos | `30` (captura: `150`) |

## Desenvolvimento local

```bash
cd apps/mcp
uv sync --extra test
uv run pytest tests/ -v

# rodar contra a API local
YABADOO_API_KEY=sk-yaba-... YABADOO_API_URL=http://localhost:8000 uv run yabadoo-mcp
```

Instalação direto do repositório (sem PyPI):

```bash
uvx --from "git+https://github.com/HENRIQUE4345/yabadoo-brain#subdirectory=apps/mcp" yabadoo-mcp
```
