К основному содержанию
MCP-сервер CX Codex

mcpstat — MCP-сервер для Claude Code: что делает и как установить

MCP-сервер mcpstat для Claude Code собирает локальную статистику вызовов, ошибок и задержек инструментов. Записывает метрики в SQLite и отдаёт их ассистенту через встроенные вызовы.

MIT ★ 6 обновлён 2026-11-16

Установить в Claude Code · Командой платформы Все способы и платформы ↓
claude mcp add --env OTEL_SDK_DISABLED=<OTEL_SDK_DISABLED> --env OTEL_PROPAGATORS=<OTEL_PROPAGATORS> --transport stdio mcpstat -- uvx mcpstat
Открыть на GitHub

Что делает mcpstat

Сервер собирает аналитику работы MCP-инструментов, промптов и ресурсов. Данные хранятся локально в базе SQLite, поэтому накопленная статистика остаётся доступной после перезапуска процессов. Дополнительно поддерживается запись аудита в текстовые лог-файлы с таймстемпами.

Встроенные инструменты get_tool_usage_stats и get_tool_catalog позволяют запрашивать метрики прямо в диалоге с моделью. Доступна система тегов для фильтрации, фиксация длительности выполнения каждого вызова и учёт использованных токенов. Для работы с фоновой базой данных сервер использует асинхронную модель с сериализацией транзакций в отдельных потоках.

Готовый демо-сервер из пакета отслеживает исключительно собственные вызовы и не умеет перехватывать трафик сторонних серверов. Чтобы собирать телеметрию со своего проекта, нужно импортировать библиотеку mcpstat прямо в код нужного Python-сервера и разметить обработчики декоратором @stat.track. Для окружения требуется Python 3.10 или новее.

Какие задачи решает

  • сохранять историю и задержку вызовов инструментов в SQLite
  • находить медленные или падающие MCP-инструменты по метрикам
  • проверять суммарный расход токенов по отдельным обработчикам
  • получать сводку использования инструментов через запрос ассистенту

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

  • Покажи статистику использования MCP-инструментов через get_tool_usage_stats
  • Выведи каталог доступных инструментов через get_tool_catalog
  • Проверь задержки и количество ошибок для последних вызовов

Как установить mcpstat

Командой платформы

claude mcp add --env OTEL_SDK_DISABLED=<OTEL_SDK_DISABLED> --env OTEL_PROPAGATORS=<OTEL_PROPAGATORS> --transport stdio mcpstat -- uvx mcpstat

Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcpstat <команда>

По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие

Вопросы о mcpstat

Как установить mcpstat в Claude Code?

Выполните команду claude mcp add mcpstat -- uvx mcpstat. Для работы с переменными трассировки запустите вариант claude mcp add --env OTEL_SDK_DISABLED=<OTEL_SDK_DISABLED> --env OTEL_PROPAGATORS=<OTEL_PROPAGATORS> --transport stdio mcpstat -- uvx mcpstat.

Что делает mcpstat?

Отслеживает вызовы инструментов, измеряет задержки, фиксирует токены и ошибки, сохраняя все метрики в локальную базу SQLite.

Может ли отдельный сервер mcpstat собирать данные с других MCP-серверов?

Нет, отдельный запущенный сервер учитывает только собственные вызовы. Чужие серверы требуют добавления библиотеки mcpstat и декораторов прямо в их Python-код.

Похожие MCP-серверы

Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →
cargo-observability getcargo Скилл cargo-observability для Claude Code настраивает мониторинг воркфлоу Cargo и шлёт оповещения при сбоях. Отслеживает процент ошибок, задержки запусков или свежесть моделей по расписанию cron. CX Codex +1 7 900установок cx-telemetry-querying coralogix Скилл cx-telemetry-querying для Claude Code, который подсказывает, где искать нужный сигнал: в логах, метриках, трейсах или RUM. Запускается на любой задаче расследования инцидента, когда ответ может лежать в телеметрии Coralogix. CX Codex +1 6 300установок Flowlines flowlines-ai Смотрите, как люди используют ваши MCP-серверы, где сломались сессии и что изменилось после релиза. Flowlines подключается к вашему воркспейсу и записывает телеметрию через инструментированные MCP-серверы. CX Codex +1 ai-observability-engineer VoltAgent Субагент ai-observability-engineer для Codex проектирует сбор трейсов, метрик и журналов для агентных систем и LLM в продакшене. Запускается при настройке наблюдаемости пайплайнов. CX Codex ★ 6 505звёзд репо troubleshoot-observability Microsoft Скилл troubleshoot-observability для Claude Code координирует поиск неисправностей в Azure. Направляет агента при анализе ошибок выполнения, задержек и настройке мониторинга. CX Codex +1 ★ 3 232звёзд репо dashboard SethGammon Скилл dashboard для Claude Code показывает состояние harness: кампании, сессии агентов, телеметрию и очереди. Он запускается по /dashboard, /do status или просьбе показать активность. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой