constellation — MCP-сервер для Claude Code
MCP-сервер, который даёт ИИ-ассистенту доступ к структуре проекта, зависимостям и связям между сущностями. Исходный код при этом никуда не уходит.
claude mcp add constellation -e CONSTELLATION_ACCESS_KEY=<CONSTELLATION_ACCESS_KEY> -- npx -y @constellationdev/mcpЧто делает constellation
Constellation разбирает код локально: CLI-инструмент проходит по проекту и вытаскивает метаданные — функции, классы, переменные, импорты, вызовы и ссылки. Наружу уходит только эта структурная информация, сами файлы остаются на машине. Ассистент через MCP-сервер шлёт запросы к графу знаний и получает ответы о том, как устроен проект.
Каждая ветка git получает отдельный набор данных, так что переключение между ветками не смешивает картину. Все запросы проходят по ключу доступа, поэтому без CONSTELLATION_ACCESS_KEY сервер не заработает — ключ подставляется в переменную окружения при регистрации.
Установка сводится к одной команде для вашей платформы. Для Claude это claude mcp add constellation -e CONSTELLATION_ACCESS_KEY=<CONSTELLATION_ACCESS_KEY> -- npx -y @constellationdev/mcp. Нужен Node.js v24+ и TypeScript v5.9+, если вы собираете что-то своё вокруг. Лицензия AGPL-3.0 — это стоит учитывать, если планируете встраивать сервер в закрытый продукт.
Какие задачи решает
- найти все места, где вызывается конкретная функция
- разобраться в незнакомом проекте перед первой правкой
- отследить зависимости между модулями без чтения всего кода
- проверить, что изменилось в структуре после переключения ветки
Примеры запросов агенту
- Покажи, какие функции вызывают
parseConfigи откуда. - Какие модули зависят от
authв текущей ветке? - Найди все классы, которые наследуются от
BaseHandler.
Как установить constellation
Командой платформы
claude mcp add constellation -e CONSTELLATION_ACCESS_KEY=<CONSTELLATION_ACCESS_KEY> -- npx -y @constellationdev/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add constellation --env CONSTELLATION_ACCESS_KEY=<CONSTELLATION_ACCESS_KEY> -- npx -y @constellationdev/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"constellation": {
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<CONSTELLATION_ACCESS_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"constellation": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@constellationdev/mcp"
],
"env": {
"CONSTELLATION_ACCESS_KEY": "<CONSTELLATION_ACCESS_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CONSTELLATION_ACCESS_KEY=<CONSTELLATION_ACCESS_KEY> constellation npx -y @constellationdev/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о constellation
Как установить constellation в Claude Code?
Выполните claude mcp add constellation -e CONSTELLATION_ACCESS_KEY=<CONSTELLATION_ACCESS_KEY> -- npx -y @constellationdev/mcp, подставив свой ключ доступа.
Что делает constellation?
Разбирает структуру проекта локально и отдаёт ассистенту метаданные о функциях, классах, импортах и связях через граф знаний. Исходный код при этом не передаётся.
Нужен ли ключ доступа для работы?
Да, все запросы проходят по CONSTELLATION_ACCESS_KEY. Без него сервер не запустится.
