MCP Integration

Cerebrumma runs as a local MCP (Model Context Protocol) server. Claude Code, Cursor, and any MCP-compatible tool can call your Brain directly — no manual inject needed.

Claude Code #

The installer registers the MCP server automatically via claude mcp add, which writes to ~/.claude.json. If you need to do it manually, run:

bash

claude mcp add cerebrumma -s user ~/.cerebrumma/run-mcp.sh

Then restart Claude Code. Verify it connected by typing /mcp — you should see Cerebrumma MCP Server · ✔ connected · 5 tools.

claude code

$ /mcp
Cerebrumma MCP Server
  Status:           ✔ connected  Command:          ~/.cerebrumma/run-mcp.sh  Config location:  ~/.claude.json  Capabilities:     tools  Tools:            5 tools
  ❯ 1. View tools    2. Reconnect    3. Disable
  ↑/↓ to navigate · Enter to select · Esc to back

If you prefer to configure it manually via JSON, add this to ~/.claude.json under mcpServers:

json

{
  "mcpServers": {
    "cerebrumma": {
      "command": "uv",
      "args": ["run", "--project", "~/.cerebrumma/mcp_server", "cerebrumma-mcp"],
      "cwd": "${workspaceFolder}"
    }
  }
}

Cursor #

Add the same config to .cursor/mcp.json in your project or to your global Cursor settings:

json

{
  "mcpServers": {
    "cerebrumma": {
      "command": "uv",
      "args": ["run", "--project", "~/.cerebrumma/mcp_server", "cerebrumma-mcp"],
      "cwd": "${workspaceFolder}"
    }
  }
}

Available tools #

Once connected, the following MCP tools are available to the AI inside your editor:

read_memoryRead all entries from episodic, semantic, and personal layers

search_memorySearch memory entries by keyword

get_protocolsReturn all procedural skills and rules

add_entryWrite a new episodic memory entry

get_statusShow entry counts across all memory layers

Dual-brain merge #

The MCP server automatically merges your global Brain (~/.cerebrum/) and local Brain (.cerebrum/) when both exist. Local entries take priority — so project-specific rules always win over global defaults.

Troubleshooting #

MCP tools not showing up? Make sure uv is in your PATH and the MCP server is installed at ~/.cerebrumma/mcp_server/. Run:

bash

uv run --project ~/.cerebrumma/mcp_server cerebrumma-mcp

If that runs without error, the server is working. Restart your editor and the tools should appear.

←Quickstart Dream Cycle→