NEAT — MCP-сервер для Claude Code: что делает и как установить
Объединяет статическую структуру кода с телеметрией OpenTelemetry в живой граф. Помогает агенту находить корень сбоя без ручного поиска по файлам.
claude mcp add --env NEAT_CORE_URL=<NEAT_CORE_URL> --transport stdio neat -- npx -y @neat.is/mcpЧто делает NEAT
Сервер связывает дерево исходного кода с поведением системы в рантайме. Парсер разбирает файлы, вызовы баз данных и внешние маршруты на уровне символов. Поверх этих узлов ложатся трассировки OpenTelemetry, привязанные к конкретным строкам. Внутри нет вызовов нейросетей. Граф строится детерминированно.
Связи между узлами хранят своё происхождение. Статические импорты извлекаются из текста, а живые вызовы подтверждаются телеметрией со счётчиком обращений. Если рантайм затихает, ребро считается устаревшим. Агент сразу читает карточки инцидентов, цепочки причин и границы влияния сбоя.
На Windows запуск npx neat.is ломается из-за расширения файла. Приходится ставить пакет глобально и вызывать бинарник neat. Для сбора живых данных сервис запускают с переменными из файла .env.neat или через opentelemetry-instrument.
Какие задачи решает
- локализовать причину падения сервиса по цепочке вызовов
- оценить зону поражения перед внесением правок в код
- выявить расхождения между исходным кодом и поведением в продакшене
- проверить архитектурные правила без построчного поиска по файлам
Примеры запросов агенту
- Запроси карточку инцидента через NEAT для узла service:checkout
- Проверь границы влияния правок для файла billing.ts перед коммитом
- Покажи расхождения между объявленными маршрутами и трассировками рантайма
Как установить NEAT
Командой платформы
claude mcp add --env NEAT_CORE_URL=<NEAT_CORE_URL> --transport stdio neat -- npx -y @neat.is/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add neat --env NEAT_CORE_URL=<NEAT_CORE_URL> -- npx -y @neat.is/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"neat": {
"command": "npx",
"args": [
"-y",
"@neat.is/mcp"
],
"env": {
"NEAT_CORE_URL": "<NEAT_CORE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"neat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@neat.is/mcp"
],
"env": {
"NEAT_CORE_URL": "<NEAT_CORE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NEAT_CORE_URL=<NEAT_CORE_URL> neat npx -y @neat.is/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о NEAT
Как установить NEAT в Claude Code?
Выполните команду claude mcp add neat -- npx -y @neat.is/mcp. Если сервис запущен удалённо, передайте адрес: claude mcp add --env NEAT_CORE_URL=<NEAT_CORE_URL> --transport stdio neat -- npx -y @neat.is/mcp.
Чем NEAT отличается от обычного поиска по файлам?
Вместо поиска подстрок инструмент сопоставляет код со спанами OpenTelemetry. Агент получает готовую цепочку причин сбоя с точными именами файлов и номерами строк.
Почему на Windows не работает команда npx neat.is?
Операционная система считает .is расширением файла и передаёт его системной ассоциации. Установите инструмент глобально через npm i -g neat.is и вызывайте команду neat.
