BumpGuard — MCP-сервер для Claude Code: проверка обновлений зависимостей
Показывает, какие строки вашего кода сломаются при обновлении зависимости, и сверяет написанный ИИ код с реально установленной версией пакета.
claude mcp add bumpguard -- uvx bumpguard-mcpЧто делает BumpGuard
BumpGuard — MCP-сервер, который отвечает на вопрос «что у меня отвалится, если я подниму версию пакета». Он разбирает публичный API установленной версии и целевой, сравнивает их и находит в вашем коде только те места, которые реально затронуты изменениями. В отчёте — символ, номер строки, серьёзность и подсказка по замене.
Работает только статическим анализом: сторонний код не импортируется и не выполняется. Целевая версия скачивается как wheel и распаковывается во временную папку, поэтому побочных эффектов от импорта и зависаний на тяжёлых пакетах не будет. Кроме проверки обновления есть инструменты для списка символов пакета, проверки импортов и сверки фрагмента кода с установленным API — это ловит вызовы функций, которых в вашей версии уже нет.
Ставьте сервер в то же окружение, где живёт проект: иначе он увидит не те пакеты, что у вас стоят. Нужен Python 3.10+. Для .NET-провайдера требуется dotnet в PATH, а разбор Java идёт прямо из байткода .jar на чистом Python. Анализ статический, поэтому пустой отчёт означает «ничего доказанно не ломается», а не гарантию — сервер сам это оговаривает в выводе.
Какие задачи решает
- узнать, какие строки кода сломает обновление pydantic с 1 на 2
- поймать вызов метода, которого нет в установленной версии SDK
- отсеять из списка изменений библиотеки те, что не касаются вашего кода
- проверить, что написанный агентом фрагмент использует реальные имена функций
- посмотреть настоящие сигнатуры публичного API пакета
Примеры запросов агенту
- Перед обновлением pandas до 2.2 проверь, не сломается ли мой пайплайн обработки данных
- Сверь этот фрагмент с установленным OpenAI SDK — есть ли там такие методы
- Покажи реальные методы класса
httpx.Client
Как установить BumpGuard
Командой платформы
claude mcp add bumpguard -- uvx bumpguard-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from bumpguard-mcp <команда>
Командой платформы
codex mcp add bumpguard -- uvx bumpguard-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from bumpguard-mcp <команда>
Файл настроек
{
"mcpServers": {
"bumpguard": {
"command": "uvx",
"args": [
"bumpguard-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from bumpguard-mcp <команда>
Файл настроек
{
"servers": {
"bumpguard": {
"type": "stdio",
"command": "uvx",
"args": [
"bumpguard-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from bumpguard-mcp <команда>
Командой платформы
gemini mcp add bumpguard uvx bumpguard-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from bumpguard-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о BumpGuard
Как установить BumpGuard в Claude Code?
Одной командой: claude mcp add bumpguard -- uvx bumpguard-mcp. Сервер запустится через uvx, отдельная установка не нужна.
Что делает BumpGuard?
Сравнивает API двух версий пакета и говорит, какие места в вашем коде затронуты изменениями. Ещё умеет проверять импорты и вызовы в написанном коде на соответствие установленной версии.
Какие языки поддерживаются?
Python, .NET и Java. Для .NET нужен dotnet в PATH, Java разбирается из байткода без JDK.
