yabadoo-mcp

MCP Server oficial do Yabadoo — conecta qualquer Claude (claude.ai, celular, Desktop, Claude Code) ao seu segundo cérebro.

Como conectar (recomendado: servidor remoto, sem instalar nada)

O Yabadoo expõe um servidor MCP remoto (Streamable HTTP) em https://api.yabadoo.io/api/v1/mcp. Gere uma API Key em app.yabadoo.io → Configurações → API Keys e escolha o cliente:

Este pacote (yabadoo-mcp) é a alternativa local/STDIO: útil sem acesso ao servidor remoto ou pra rodar do checkout do repositório. As tools são as mesmas (paridade travada por teste).

Alternativa local (STDIO)

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

Claude Desktop

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

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

Claude Code (CLI)

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 no .mcp.json do projeto (compartilhável via git — sem a key, use variável de ambiente).

O método: prompts do servidor

O servidor expõe 4 prompts que aparecem como slash commands no cliente (no Claude Code: /mcp__yabadoo__bom-dia):

Tools (46)

Busca e leitura

Documentos

Read-layer cru (JSON exaustivo)

Escrita aditiva (sem confirmação)

Corretivas (gated pelo dono)

Ligadas em Configurações → API Keys (2 toggles, desligados por padrão):

Variáveis de ambiente (modo local)

Desenvolvimento local

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):

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