# mindbase

Turns papers, articles and notes into a markdown wiki on your disk: the model reads a source, links it to the rest, flags contradictions and writes pages once you approve.

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

## What it does

MindBase follows the LLM Wiki idea. Your raw material sits in `sources/` and the model never rewrites it. The maintained part — `context.md` and `sources/research/` — changes only after you tick items in the proposed plan. Index, snapshots and lint findings in `state/`, `logs/` and `artifacts/` are derived and rebuild from scratch.

Three operations drive it. Ingest walks through a new source and proposes what belongs in the wiki. Build regenerates `context.md` from everything not yet digested. Lint re-reads the whole wiki and quotes the sentences that contradict each other. That last step is where a vector store falls short: nothing is re-derived at query time, the synthesized answer already lives in the files.

The server starts with `npx -y mindbase-mcp`, and `MINDBASE_DATA_DIR` points at your data. The browser app wants Node 20+ and picks a local Ollama model for your RAM, so cloud keys stay optional. In Claude the marketplace plugin adds sub-agents with narrow tool allowlists — the builder gets no file-write tool, only an atomic MCP call.

One catch: in Cursor and Windsurf the model often misses a plain “add to mindbase” request unless you add a routing conventions block to your rules file.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MINDBASE_DATA_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MINDBASE_DATA_DIR=<MINDBASE_DATA_DIR> --transport stdio mindbase -- npx -y mindbase-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mindbase --env MINDBASE_DATA_DIR=<MINDBASE_DATA_DIR> -- npx -y mindbase-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mindbase": {
            "command": "npx",
            "args": [
                "-y",
                "mindbase-mcp"
            ],
            "env": {
                "MINDBASE_DATA_DIR": "<MINDBASE_DATA_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mindbase": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mindbase-mcp"
            ],
            "env": {
                "MINDBASE_DATA_DIR": "<MINDBASE_DATA_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MINDBASE_DATA_DIR=<MINDBASE_DATA_DIR> mindbase npx -y mindbase-mcp
```
Replace <…> with your own values

## When to use it
- link scattered articles into one cross-referenced wiki
- surface contradictions between old and new notes
- regenerate `context.md` after a batch of new sources
- keep a personal knowledge base as plain markdown for git and grep
- expose wiki operations to a coding agent over MCP

## Example prompts
- Add this article to mindbase and show me the plan before writing
- Rebuild `context.md` from everything not yet ingested
- Run a lint pass and quote the claims that conflict

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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