trace-mcp

MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов

MCP-сервер

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • Читает и индексирует весь код проекта
  • Держит локальный фоновый процесс
Все причины и проверки

nikolai-vysotskyi/trace-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/trace-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio trace-mcp -- npx -y trace-mcp@3.32.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"trace-mcp","type":"stdio","command":"npx","args":["-y","trace-mcp@3.32.0"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "trace-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Выполните в терминале

codex mcp add trace-mcp -- npx -y trace-mcp@3.32.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.trace-mcp]
command = "npx"
args = ["-y", "trace-mcp@3.32.0"]

Если файл уже есть, допишите блок в конец.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "trace-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp@3.32.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит a493b16.

Текст для агента

Установи trace-mcp: npm install -g trace-mcp, затем trace init для подключения к агенту и trace add в корне репозитория для индексации. После этого пользуйся его инструментами через MCP.

Другие способы из описания автора
npm install -g trace-mcp
trace init
trace add

Глобальная установка, trace init подключает сервер к агенту, trace add индексирует текущий репозиторий.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

trace-mcp индексирует репозиторий в граф с учетом фреймворков и держит его свежим по мере изменений. Агент вместо десятков вызовов grep и чтения файлов спрашивает через MCP: что сломается при правке, откуда идет поток запроса, какие символы не покрыты тестами. Сервер понимает связи между слоями, например переход от контроллера к шаблону или зависимость через внедрение. Работает локально, код никуда не уходит, ставится как отдельный сервер или как плагин для Claude Code и Codex.

Для кого. Для разработчиков, которые хотят снизить расход токенов и число шагов агента на больших кодовых базах.

Подходит, если

  • Агент в большой кодовой базе снова и снова перечитывает одни и те же файлы
  • Нужно понять радиус изменения перед правкой символа или модели
  • Нужно проследить поток запроса или найти код без тестов

Не подходит, если

  • Проект маленький, и агент справляется чтением напрямую
  • Нельзя запускать локальный фоновый процесс индексации

Пример запроса к агенту

Что сломается, если я поменяю эту модель, покажи затронутый код через trace

Ограничения

Нужен установленный сервер и локальная индексация, для больших репозиториев она занимает время и память. Часть возможностей относится к платному тарифу и десктопному приложению, базовый MCP-сервер и CLI открыты по лицензии MIT. Точность подсказок зависит от поддержки конкретного фреймворка.

Как отключить. Уберите сервер из конфигурации MCP вашего агента или удалите пакет: npm uninstall -g trace-mcp.

MCP

Транспорт
stdio
Авторизация
не нужна

Проверка безопасности

  • Читает и индексирует весь код проекта
  • Держит локальный фоновый процесс

Коротко о README

README объясняет, что агенты дорого платят за повторную работу: каждый ход они заново читают файлы и обходят зависимости. trace-mcp строит граф кода один раз и отдает его через MCP, поэтому вместо множества вызовов grep агент получает ответ одним обращением. Заявлена поддержка десятков фреймворков и языков, память решений, привязанная к символам, и поиск по прошлым сессиям. Ставится через npm глобально, дальше trace init и trace add. Есть десктопное приложение как визуальный обозреватель того же индекса.

Частые вопросы

Код уходит на сторонний сервер?

Нет, индекс строится и хранится локально, сервер отвечает агенту с вашей машины.

С какими агентами работает?

С Claude Code, Cursor, Codex, Windsurf и другими клиентами MCP, есть плагины для Claude Code и Codex.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.Звезды репозитория
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.Звезды репозитория
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.Звезды репозитория

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.Звезды репозитория
Foxx AItrace-mcp

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.