# mcp

A local MCP server connects ModelBrain to AI assistants, giving them shared memory stored on your computer.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: ModelBrain
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ModelBrain/modelbrain-mcp
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/modelbrain-mcp

## What it does

This package links an MCP client with the ModelBrain desktop app that is already running locally. It exposes tools for saving and retrieving information, removing stored items, expanding context, and syncing connectors. The memory engine remains in ModelBrain; the package locates and starts its MCP binary over stdio.

Most clients can use `npx -y modelbrain-mcp` in their MCP configuration. Supported systems are macOS on Apple Silicon and Windows on x64 or arm64. ModelBrain must be installed first. Without the desktop app, the wrapper exits after showing where to obtain it.

ModelBrain can register itself directly with Claude Code and Cursor. For Codex, GitHub Copilot, Gemini CLI, and other clients, add the server configuration manually.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -- npx -y modelbrain-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add modelbrain-mcp -- npx -y modelbrain-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "modelbrain-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "modelbrain-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "modelbrain-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "modelbrain-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add modelbrain-mcp npx -y modelbrain-mcp
```

## When to use it
- keep project context across assistant sessions
- retrieve previously saved project details
- remove outdated memories
- expand stored information on request
- sync data through connectors

## Example prompts
- Remember the database migration decision for this project.
- Recall the naming conventions saved for this codebase.
- Forget the stored rule for the old API.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md