Vulcanus — MCP-сервер для Claude Code: что делает и как установить
Хранит контекст проектов в структурированных Markdown-заметках с версиями Git. Помогает ассистенту быстро вспоминать правила и архитектуру через MCP.
claude mcp add vulcanus -- npx -y @sunsato/vulcanusЧто делает Vulcanus
Vulcanus заменяет разрастающиеся конфигурационные файлы единым хранилищем памяти в формате Markdown под контролем Git. Вместо чтения всей истории целиком агент загружает карту вызова, краткую выжимку Capsule, а за деталями обращается к отдельным заметкам правил или решений. Структуру можно развернуть с нуля либо сгенерировать из экспортов истории сессий Claude Code, ChatGPT, Codex или Cursor.
Для работы сервера обязательно требуется Node.js версии не ниже 22.12. Утилиту лучше ставить глобально, иначе хуки и вызовы инструментов не найдут исполняемый файл в системном PATH. Встроенная команда vulcanus doctor проверяет целостность ссылок между документами, чтобы память не устаревала незаметно.
Метки видимости public или private служат лишь инструкцией для языковой модели и не шифруют локальные файлы на диске. Хранилище работает полностью локально без создания внешних аккаунтов.
Какие задачи решает
- сохранить архитектурные решения между перезапусками сессий агента
- структурировать правила проекта по отдельным Markdown-файлам
- перенести историю чатов из Cursor, ChatGPT или Codex в общее хранилище
- проверить битые ссылки в базе знаний через
vulcanus doctor
Примеры запросов агенту
- Вспомни правила и контекст проекта из хранилища Vulcanus
- Покажи статистику использования токенов хранилища через vulcanus stats
- Проверь целостность связей между проектными заметками
Как установить Vulcanus
Командой платформы
claude mcp add vulcanus -- npx -y @sunsato/vulcanusКомандой платформы
codex mcp add vulcanus -- npx -y @sunsato/vulcanusФайл настроек
{
"mcpServers": {
"vulcanus": {
"command": "npx",
"args": [
"-y",
"@sunsato/vulcanus"
]
}
}
}Файл настроек
{
"servers": {
"vulcanus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sunsato/vulcanus"
]
}
}
}Командой платформы
gemini mcp add vulcanus npx -y @sunsato/vulcanusПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Vulcanus
Как установить Vulcanus в Claude Code?
Выполните команду claude mcp add vulcanus -- npx -y @sunsato/vulcanus в терминале. Для постоянной работы утилит репозиторий рекомендует поставить пакет глобально через npm install -g @sunsato/vulcanus.
Что делает Vulcanus?
Сервер организует послойную базу знаний проекта в виде Markdown-файлов и отдаёт нужный контекст агенту по протоколу MCP. Это избавляет от необходимости каждый раз пересказывать правила заново.
Какие требования нужны для запуска Vulcanus?
Понадобится установленный Node.js версии 22.12 или новее. Все файлы хранятся локально, поэтому регистрация аккаунтов или внешние ключи не требуются.
