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