Brain MCP Server

# Brain MCP Server MCP server exposing Brain service operations as tools via FastMCP. ## Tools - `save_to_brain` - Save thought with full metadata - `quick_capture` - Quick capture with auto-classification - `search_brain` - Search thoughts by text query - `list_recent` - List recent entries with filters - `get_entry` - Fetch specific entry by ID ## Transports - **stdio** - Local development (default) - **SSE** - Remote access via HTTP (with OAuth 2.0 support) For OAuth configuration and remote access setup, see [OAUTH_SETUP.md](OAUTH_SETUP.md). ## Local Development ```bash # Install dependencies pip install -r requirements.txt # Run with stdio transport python brain_mcp_server.py # Run with SSE transport MCP_PORT=8084 MCP_TRANSPORT=sse python brain_mcp_server.py # Test with MCP inspector mcp dev brain_mcp_server.py ``` ## Docker Deployment ```bash docker compose up -d ``` Builds from GitHub and runs with SSE transport on port 8084. ## Environment Variables | Variable | Default | Description | |----------|---------|-------------| | BRAIN_API_BASE | https://n8n.gregslab.org/webhook | n8n Brain webhooks URL | | BRAIN_API_TIMEOUT | 30.0 | API timeout in seconds | | MCP_TRANSPORT | stdio | Transport mode (stdio/sse) | | MCP_PORT | 8084 | SSE server port | | MCP_HOST | 0.0.0.0 | SSE server host | | BASE_URL | http://{MCP_HOST}:{MCP_PORT} | Base URL for OAuth metadata | | OAUTH_ENABLED | false | Enable OAuth (advisory flag) |