@ourmem/mcp

MCP (Model Context Protocol) server for Cerebro — persistent memory for AI agents.

Works with Cursor, VS Code Copilot, Claude Desktop, Windsurf, and any MCP-compatible client.

Setup

1. Get an API Key

Self-host the Cerebro server and create a tenant:

docker run -d -p 8080:8080 ghcr.io/mingxy-cerebro/cerebro-server:latest
curl -sX POST http://localhost:8080/v1/tenants -H "Content-Type: application/json" -d '{"name": "my-workspace"}'

2. Configure your MCP client

Claude Desktop (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "ourmem": {
      "command": "npx",
      "args": ["-y", "@ourmem/mcp"],
      "env": {
        "OMEM_API_KEY": "your-api-key",
        "OMEM_API_URL": "http://localhost:8080"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "ourmem": {
      "command": "npx",
      "args": ["-y", "@ourmem/mcp"],
      "env": {
        "OMEM_API_KEY": "your-api-key",
        "OMEM_API_URL": "http://localhost:8080"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | memory_store | Save a new memory | | memory_search | Semantic search with optional tag filtering | | memory_list | Browse recent memories | | memory_ingest | Ingest conversation messages for smart extraction | | memory_get | Retrieve a memory by ID | | memory_update | Update memory content or tags | | memory_forget | Delete a memory | | memory_stats | Get memory statistics | | memory_profile | View synthesized user profile |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | OMEM_API_KEY | Yes | — | Your Cerebro API key | | OMEM_API_URL | No | http://localhost:8080 | API server URL |

License

Apache-2.0