mcpstat — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер mcpstat для Claude Code собирает локальную статистику вызовов, ошибок и задержек инструментов. Записывает метрики в SQLite и отдаёт их ассистенту через встроенные вызовы.
MIT ★ 6 обновлён 2026-11-16
claude mcp add --env OTEL_SDK_DISABLED=<OTEL_SDK_DISABLED> --env OTEL_PROPAGATORS=<OTEL_PROPAGATORS> --transport stdio mcpstat -- uvx mcpstatЧто делает 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 <команда>
Командой платформы
codex mcp add mcpstat --env OTEL_SDK_DISABLED=<OTEL_SDK_DISABLED> --env OTEL_PROPAGATORS=<OTEL_PROPAGATORS> -- uvx mcpstatВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcpstat <команда>
Файл настроек
{
"mcpServers": {
"mcpstat": {
"command": "uvx",
"args": [
"mcpstat"
],
"env": {
"OTEL_SDK_DISABLED": "<OTEL_SDK_DISABLED>",
"OTEL_PROPAGATORS": "<OTEL_PROPAGATORS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcpstat <команда>
Файл настроек
{
"servers": {
"mcpstat": {
"type": "stdio",
"command": "uvx",
"args": [
"mcpstat"
],
"env": {
"OTEL_SDK_DISABLED": "<OTEL_SDK_DISABLED>",
"OTEL_PROPAGATORS": "<OTEL_PROPAGATORS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcpstat <команда>
Командой платформы
gemini mcp add -e OTEL_SDK_DISABLED=<OTEL_SDK_DISABLED> -e OTEL_PROPAGATORS=<OTEL_PROPAGATORS> 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-код.