# Cartographer

A team wiki that agents read and extend through MCP tools, with link checks and schema validation on every write. Keeps what one session learned.

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

## What it does

Cartographer stores a knowledge base as a git repo of Markdown and YAML files, readable in Obsidian or any editor. Agents touch it only through MCP tools, so broken links and silent corruption don't get in. Each write becomes a single commit; schema checks, lint and an audit log run alongside.

The same repo carries the agent setup: skills, subagents, hooks and standing instructions, delivered to each client in its native format. Change it once and the machines agree again. The binary also serves the Atlas, a read-only web view of the graph with search and a list of findings.

You need Docker and an empty git repository you own for the first base. The project is pre-1.0: breaking changes bump the minor version and get named in the changelog. Secrets sit encrypted with SOPS and are resolved when a concept refers to them.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add cartographer -- docker run -i --rm ghcr.io/beppetemp/cartographer:v0.25.1
```

### Codex

**Platform CLI**
```bash
codex mcp add cartographer -- docker run -i --rm ghcr.io/beppetemp/cartographer:v0.25.1
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cartographer": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/beppetemp/cartographer:v0.25.1"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cartographer": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/beppetemp/cartographer:v0.25.1"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add cartographer docker run -i --rm ghcr.io/beppetemp/cartographer:v0.25.1
```

## When to use it
- keep one wiki that agents from several developers add to
- find broken links and stale notes in a knowledge base
- ship skills and hooks to every client from one place
- keep a commit history of what agents changed
- use a stored secret without putting it in plaintext

## Example prompts
- Check the knowledge base: what is broken, stale or missing?
- Add a note about why staging fails to the shared wiki
- Which skills, subagents and hooks does this base give my agent?

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