Cartographer — MCP-сервер для Claude Code: общая база знаний агентов
Общая вики для агентов команды: заметки пишутся через MCP-инструменты, а сервер проверяет ссылки и схему. Пригодится, когда знания теряются между сессиями.
claude mcp add cartographer -- docker run -i --rm ghcr.io/beppetemp/cartographer:v0.25.1Что делает Cartographer
Cartographer держит базу знаний в git-репозитории: обычный Markdown плюс YAML, открывается в Obsidian или любом редакторе. Агент читает и дополняет её только через MCP-инструменты, поэтому не может оставить после себя битые ссылки или потерянную историю. На каждую запись идёт один коммит, рядом проверка схемы, линт и журнал изменений.
Та же база раздаёт настройку агентов: скиллы, субагенты, хуки и постоянные инструкции лежат в ней и уходят в каждый клиент в его собственном формате. Поправил один раз — машины сходятся к общей версии. В бинарник встроен Atlas: граф знаний в вебе, поиск и список того, что сломалось.
Для запуска нужен Docker и пустой git-репозиторий под первую базу. Без репозитория сервер не с чего начинать. Версия до 1.0: ломающие изменения поднимают минорную версию, их перечисляют в changelog. Секреты хранятся зашифрованными через SOPS и подставляются по запросу.
Какие задачи решает
- собрать общую вики, которую дополняют агенты разных разработчиков
- проверить базу знаний на битые ссылки и устаревшие записи
- раздать скиллы и хуки во все клиенты из одного места
- сохранить историю правок агента коммитами в git
- подставить секрет из хранилища, не держа его в открытом виде
Примеры запросов агенту
- Проверь базу знаний: что сломано, устарело или пропущено?
- Оставь заметку в общей вики о том, почему падает staging
- Какие скиллы, субагенты и хуки эта база поставит в мой агент?
Как установить Cartographer
Командой платформы
claude mcp add cartographer -- docker run -i --rm ghcr.io/beppetemp/cartographer:v0.25.1Командой платформы
codex mcp add cartographer -- docker run -i --rm ghcr.io/beppetemp/cartographer:v0.25.1Файл настроек
{
"mcpServers": {
"cartographer": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/beppetemp/cartographer:v0.25.1"
]
}
}
}Файл настроек
{
"servers": {
"cartographer": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/beppetemp/cartographer:v0.25.1"
]
}
}
}Командой платформы
gemini mcp add cartographer docker run -i --rm ghcr.io/beppetemp/cartographer:v0.25.1По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Cartographer
Как установить Cartographer в Claude Code?
Одной командой: claude mcp add cartographer -- docker run -i --rm ghcr.io/beppetemp/cartographer:v0.25.1. Docker должен быть уже установлен.
Что делает Cartographer?
Даёт агентам общую базу знаний в git: поиск, запись и линт через MCP-инструменты. Заодно раздаёт настройку агентов по клиентам.
Что нужно подготовить до запуска?
Docker и пустой git-репозиторий, которым вы владеете, — под первую базу знаний.
