Tiltmeter — MCP-сервер для Claude Code: API и установка
Tiltmeter отслеживает изменения JSON-ответов сторонних API и сообщает агенту о дрейфе схемы до того, как код начнёт доверять новым данным.
MIT ★ 1 обновлён 2026-10-28
claude mcp add --env TILTMETER_CONFIG=<TILTMETER_CONFIG> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --transport stdio tiltmeter -- uvx tiltmeterЧто делает Tiltmeter
Tiltmeter проверяет ответы сторонних JSON API и сравнивает их форму с сохранённым базовым состоянием. Он замечает переименованные и удалённые поля, изменения типов, null и новые значения. MCP-инструменты has_drifted, get_schema, get_changes, check_api и check_all дают агенту сведения о схеме и истории изменений.
Сервер можно запускать локально через uvx tiltmeter. Команда tiltmeter init создаёт tiltmeter.yaml, а tiltmeter check проверяет API из конфигурации; для CI доступны коды завершения, при критическом дрейфе сборка завершается ошибкой. Tiltmeter хранит данные в SQLite, не отправляет тела ответов языковой модели и поддерживает уведомления Slack и webhook.
Для объяснений изменений нужен ключ ANTHROPIC_API_KEY. Для наблюдения за собственными API заранее создайте конфигурацию через tiltmeter init, иначе серверу нечего проверять.
Какие задачи решает
- обнаружить изменение схемы JSON API
- найти переименованные поля в ответе
- проверить типы данных перед вызовом API
- остановить CI при критическом дрейфе
- передать агенту изменения для исправления кода
Примеры запросов агенту
- Проверь API перед использованием и вызови
has_driftedдля нужной конечной точки. - Получи ожидаемую JSON-схему через
get_schema, затем сравни её с ответом API. - Запусти
check_allи покажи изменения, которые могут сломать код.
Как установить Tiltmeter
Командой платформы
claude mcp add --env TILTMETER_CONFIG=<TILTMETER_CONFIG> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --transport stdio tiltmeter -- uvx tiltmeterВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiltmeter <команда>
Командой платформы
codex mcp add tiltmeter --env TILTMETER_CONFIG=<TILTMETER_CONFIG> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx tiltmeterВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiltmeter <команда>
Файл настроек
{
"mcpServers": {
"tiltmeter": {
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"TILTMETER_CONFIG": "<TILTMETER_CONFIG>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiltmeter <команда>
Файл настроек
{
"servers": {
"tiltmeter": {
"type": "stdio",
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"TILTMETER_CONFIG": "<TILTMETER_CONFIG>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiltmeter <команда>
Командой платформы
gemini mcp add -e TILTMETER_CONFIG=<TILTMETER_CONFIG> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> tiltmeter uvx tiltmeterВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiltmeter <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Tiltmeter
Как установить Tiltmeter в Claude Code?
Выполните claude mcp add tiltmeter -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx tiltmeter.
Что делает Tiltmeter?
Он следит за формой ответов сторонних JSON API, фиксирует изменения схемы и сообщает о потенциально ломающем дрейфе агенту и CI.
Нужен ли ключ API для работы Tiltmeter?
Для объяснений изменений нужен ANTHROPIC_API_KEY. Базовая проверка API и сравнение схемы запускаются через tiltmeter check.