inquisitor — MCP-сервер для Claude Code: диагностика и установка
inquisitor помогает агенту проверять причины ошибки небольшими пробами и углублять расследование, когда данных не хватает. Пригодится для поиска сложных сбоев в проекте.
claude mcp add inquisitor -- uvx inquisitor-mcpЧто делает inquisitor
Сначала агент формулирует, что должно работать и что нельзя сломать, затем выбирает дешёвую проверку основной версии причины. По результату он исправляет локальную очевидную ошибку или переходит к более глубокому разбору. Поиск в сети и трассировка кода нужны лишь тогда, когда локальных свидетельств мало.
Сервер ведёт журнал отвергнутых версий и доказательств против них. После двух неудачных объяснений одного типа агент должен пересмотреть исходное предположение или границы поиска, а не повторять тот же ход. Это помогает избежать слепых повторов, но добавляет структуру даже в расследование: очевидная опечатка должна оставаться простой задачей.
Для запуска через Claude Code команда использует uvx inquisitor-mcp; в README также указана версия Python 3.12+. Сервер описан как MCP-инструмент, а поведенческий слой — как отдельный скилл. Глубину могут повысить изменения инфраструктуры, авторизации, миграций и другие перечисленные триггеры.
Какие задачи решает
- проверить основную причину сбоя до исправления
- проследить путь выполнения кода при непонятной ошибке
- зафиксировать версии причины, которые уже опровергнуты
- пересмотреть ход расследования после повторных неудач
Примеры запросов агенту
- Разберись, почему запрос падает в рантайме, и сначала проверь самую вероятную причину.
- Найди причину ошибки, которая проявляется только в продакшене, и покажи, какие данные её опровергают.
- После двух неудачных исправлений пересмотри исходные предположения и проверь другую версию.
Как установить inquisitor
Командой платформы
claude mcp add inquisitor -- uvx inquisitor-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from inquisitor-mcp <команда>
Командой платформы
codex mcp add inquisitor -- uvx inquisitor-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from inquisitor-mcp <команда>
Файл настроек
{
"mcpServers": {
"inquisitor": {
"command": "uvx",
"args": [
"inquisitor-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from inquisitor-mcp <команда>
Файл настроек
{
"servers": {
"inquisitor": {
"type": "stdio",
"command": "uvx",
"args": [
"inquisitor-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from inquisitor-mcp <команда>
Командой платформы
gemini mcp add inquisitor uvx inquisitor-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from inquisitor-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о inquisitor
Как установить inquisitor в Claude Code?
Выполните claude mcp add inquisitor -- uvx inquisitor-mcp. Для запуска также нужна Python 3.12+.
Что делает inquisitor?
Он помогает агенту проверять гипотезы о причине проблемы, выбирать глубину разбора по результатам проб и сохранять опровергнутые версии.
Как inquisitor предотвращает повтор одной и той же попытки?
Сервер хранит журнал неудачных гипотез с причинами отказа. После двух опровергнутых версий одного типа агент должен пересмотреть предположение или расширить границы расследования.
