MindReader MCP Server

Connect MindReader to Claude Code, Cursor, or any MCP-compatible client. Gives your AI assistant persistent memory backed by a knowledge graph.

Prerequisites

MindReader V2 running locally (npm start)
Node.js 18+

Install

git clone https://github.com/flu012/mindreader-mcp.git
cd mindreader-mcp
npm install

Setup with Claude Code

Add to your Claude Code settings (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "mindreader": {
      "command": "node",
      "args": ["/path/to/mindreader-mcp/src/index.js"],
      "env": {
        "MINDREADER_URL": "http://localhost:18900"
      }
    }
  }
}

If MindReader has authentication enabled, add your token:

{
  "mcpServers": {
    "mindreader": {
      "command": "node",
      "args": ["/path/to/mindreader-mcp/src/index.js"],
      "env": {
        "MINDREADER_URL": "http://localhost:18900",
        "MINDREADER_TOKEN": "your-api-token"
      }
    }
  }
}

Setup with Cursor

Add to Cursor's MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "mindreader": {
      "command": "node",
      "args": ["/path/to/mindreader-mcp/src/index.js"],
      "env": {
        "MINDREADER_URL": "http://localhost:18900"
      }
    }
  }
}

Tools

| Tool | Description | |---|---| | memory_search | Search the knowledge graph for entities, facts, and relationships | | memory_store | Store information using LLM preprocessing (auto-extracts entities) | | memory_create | Create/update entities directly without LLM (precise control) | | memory_entities | List entities in the knowledge graph | | memory_recall | Recall relevant memories for a given context | | memory_stats | Get knowledge graph statistics |

Examples

Once configured, Claude Code can use the tools naturally:

"Remember that Alice is a senior engineer at Acme Corp"
"What do you know about the payments project?"
"List all the entities in my knowledge graph"
"Create an entity for the new API gateway project with tags backend, infrastructure"

Environment Variables

| Variable | Default | Description | |---|---|---| | MINDREADER_URL | http://localhost:18900 | MindReader API base URL | | MINDREADER_TOKEN | (empty) | Bearer token for authentication |

License

MIT

mindreader-mcp