# mushroomdb

mushroomdb stores entities and derives their links from rules. Connect it when an agent needs to remember facts and explain how items relate.

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

## What it does

mushroomdb gives an agent MCP access to a graph database stored on disk. The agent can save facts, retrieve or remove them, explain why two entities connect, and inspect links from an earlier date or Git commit. You define relationship rules, such as matching a property or checking how lists overlap. When entity properties change, the database recalculates affected links and removes ones that no longer qualify.

Queries can also preview the links a change would add or remove, and access can vary by caller role. Vector rules require embeddings that you supply. The working graph stays in memory, only one writer can operate at a time, and interactive transactions are unsupported. That rules out projects that depend on concurrent writers or interactive transaction workflows.

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

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- store facts about entities for an agent
- derive graph links from declared rules
- find the rule and evidence behind a connection
- preview a property change before saving it

## Example prompts
- Remember that project Atlas uses PostgreSQL.
- Find the saved facts about project Atlas.
- Explain why these two entities are connected.

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

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