Log inSubmit server
Mushroomdb logo

Mushroomdb

Embedded graph database for agent memory with rule-derived edges, explanations, temporal queries, search, and role-aware views.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Mushroomdb

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mushroomdb": {
      "command": "npx",
      "args": [
        "-y",
        "mushroomdb"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y mushroomdb

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 2d ago.

Overview

The mushroomdb MCP server exposes an embedded Rust graph database through MCP tools for storing entities, deriving relationships, searching memory, and explaining associations. Rules maintain and retract edges automatically as properties change, while queries can inspect historical graph state, simulate changes, and apply caller roles or masks. It runs locally against a directory on disk and can also be embedded through Rust or Python interfaces. Reach for it when an agent needs explainable, evolving entity relationships rather than a static document store.

Use cases

  • Store agent notes as entities and relationships
  • Explain why two entities are connected
  • Preview relationship changes before writing
  • Search historical graph state by date or commit
  • Import Git commits, files, pull requests, and authors

Key features

  • Rule-derived and retractable graph edges
  • MCP tools for memory, search, and graph queries
  • Association explanations with scores and evidence
  • Historical edge inspection and what-if analysis
  • Full-text, vector, hybrid, and pairwise similarity search
  • Role, namespace, key, and mask-based scoping

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

6/6 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5h ago via OSV.dev · mushroomdb (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
npm downloads1.7kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Mushroomdb works

What mushroomdb does

The mushroomdb MCP server gives agents an entity store backed by an embedded graph database. Entities become nodes, while associations can be derived from shared values, foreign-key relationships, embeddings, geographic proximity, or other declared predicates. A rule is stored as part of the schema; later writes recalculate matching edges and remove edges whose supporting data no longer qualifies.

The store is intended for local agent memory. It keeps facts, relationships, similarity results, and lineage in a directory on disk without requiring an account, hosted endpoint, or model call during writes unless embeddings are enabled. The project is pre-1.0, so APIs and formats may change between minor versions.

How it works

Agents can write notes with remember, search indexed text with recall, and inspect structured graph data with query. suggest_rules can identify repeated field values that may justify a relationship rule, but a proposed rule is not activated until create_rule approves it. Once active, the rule participates in subsequent writes.

Relationship inspection is a central use case. explain_association reports the rule, score, predicate, and values that support a link. node_edges and neighborhood list related nodes, while edges_at reconstructs the relationships a node had on a past date or commit index. what_if calculates edges that a proposed property change would add or remove without modifying the store.

The server also supports full-text and vector-oriented retrieval. find_similar can search by a query vector or by a rule-derived edge type, hybrid_search combines full-text and vector rankings, and pairwise_similar compares a caller-provided set of keys without using HNSW. find_similar uses a default minimum threshold of 0.8 on every interface.

Setup and configuration

Install the local MCP setup with:

Terminal
npx mushroomdb install --db ./memory

The command creates the /mushroom skill, configures an MCP server exposing the association surface, and writes session hooks. The MCP command can list the task-oriented tools first with mushroomdb mcp <db> --all-tools.

The database can also be used as a Rust library, Python module, or sidecar. ingest-git remains available as a data source for commits, pull requests, files, and authors. Schema files can be applied idempotently with mushroomdb schema apply <dir> <schema.json>, including rules, views, and full-text indexes.

Tools and capabilities

The mushroomdb MCP server exposes twenty-three tools on its entity store. Notable capabilities include:

  • Write notes and provision unknown referenced entities with remember.
  • Retrieve ranked free-text matches with recall.
  • Query graph structure using Cypher through query.
  • Explain rule-derived links with supporting evidence.
  • List node edges, neighborhoods, and historical edges.
  • Preview relationship changes with what_if.
  • Apply per-call masks or scoped, read-only handles with roles, namespaces, and key restrictions.
  • Load nodes and edges atomically with conflict handling through ingest_batch.

HTTP role tokens provide the actual enforcement boundary for access control; in-process scopes and masks are cooperative argument handling rather than security isolation.

Limitations and notes

The project is explicitly alpha and may change between minor releases. The former code-graph interface was removed in version 0.7; applications that need it must use the 0.6.x line. Historical queries depend on recorded timestamps or commits: a store without timing information reports that fact instead of guessing. The local setup is not, by itself, a remote authorization boundary.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mushroomdb

mushroomdb is an MCP server that connects agents to a local embedded graph database and exposes tools such as remember, recall, query, explain_association, edges_at, and what_if. It stores entities, derives rule-based relationships, retracts stale edges, supports historical inspection, and applies role or mask-based views to queries.

Run `npx mushroomdb install --db ./memory`. The command creates the `/mushroom` skill, configures the MCP server, and writes session hooks for the selected database directory.

Yes. Use `explain_association` to see the rule, score, predicate, and values that produced each rule-derived edge between the two entities.

Yes. Use `edges_at` with a date or zero-based commit index to inspect the edges a node had at that point. The `mushroomdb asof` command can replay the write-ahead log for a historical query.

Yes, queries can receive a role or mask, and scoped handles can restrict roles, namespaces, and keys. These in-process controls are cooperative; HTTP role tokens provide the actual enforcement boundary.

Related MCP servers

All in Databases All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMushroomdb AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mushroomdb?style=directory)](https://allmcps.com/mcp/mushroomdb)
HTML Embed
<a href="https://allmcps.com/mcp/mushroomdb"><img src="https://allmcps.com/api/badge/mushroomdb?style=directory" alt="Mushroomdb on AllMCPs" /></a>