gut — MCP-сервер для Claude Code: решения да/нет на малых моделях
Даёт агенту готовые решения по мелким вопросам: спам или нет, чья команда, насколько срочно. Ответы — YES, NO или UNSURE.
claude mcp add --env TYPESAFE_API_KEY=<TYPESAFE_API_KEY> --env GUT_BACKEND=<GUT_BACKEND> --env GUT_MODEL=<GUT_MODEL> --env GUT_BASE_URL=<GUT_BASE_URL> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --transport stdio gut -- uvx gutfeel-mcpЧто делает gut
gut превращает оценочные вопросы в одну строку кода: gut.likely(comment, "is spam") даёт да или нет, gut.classify(ticket, Team) выбирает вариант из Enum, gut.rate(ticket, ["can wait", "this week", "right now"]) ставит оценку по шкале. Модель не генерирует текст, а возвращает вероятности, поэтому парсить ответ не нужно. Когда уверенности не хватает, ask_human=True даёт третий исход — gut.UNSURE, и решение уходит человеку.
MCP-сервер gutfeel-mcp ставится поверх Python-пакета gutfeel и запускается через uvx. Бэкенд выбирается конфигурацией: Jev от TypeSafe AI, Jev через OpenRouter, локальная NLI-модель на CPU, любая модель через OpenAI-совместимый сервер или Cascade, который сначала спрашивает самое дешёвое и передаёт дальше только непонятное ему. Для Jev нужен TYPESAFE_API_KEY, для OpenRouter — OPENROUTER_API_KEY; без ключа можно поднять локальный бэкенд.
Версия до 1.0, лицензия Apache-2.0. Пакет на PyPI называется gutfeel, потому что имя gut занято, а импорт остаётся коротким: import gut. В тестах вместо модели работает gut.FakeBackend с заранее заданными ответами.
Какие задачи решает
- отсеять спам в комментариях без регулярных выражений
- определить, какая команда владеет тикетом
- расставить приоритеты в очереди обращений
- проверить, закончил ли агент задачу
- разметить сотни файлов или результатов поиска одной командой
Примеры запросов агенту
- Проверь через gut, спам ли этот комментарий, и спрячь его, если да
- Определи через gut, какая команда должна взять этот тикет
- Прогони список файлов через gut и оставь только те, где есть повторные попытки запросов
Как установить gut
Командой платформы
claude mcp add --env TYPESAFE_API_KEY=<TYPESAFE_API_KEY> --env GUT_BACKEND=<GUT_BACKEND> --env GUT_MODEL=<GUT_MODEL> --env GUT_BASE_URL=<GUT_BASE_URL> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --transport stdio gut -- uvx gutfeel-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gutfeel-mcp <команда>
Командой платформы
codex mcp add gut --env TYPESAFE_API_KEY=<TYPESAFE_API_KEY> --env GUT_BACKEND=<GUT_BACKEND> --env GUT_MODEL=<GUT_MODEL> --env GUT_BASE_URL=<GUT_BASE_URL> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -- uvx gutfeel-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gutfeel-mcp <команда>
Файл настроек
{
"mcpServers": {
"gut": {
"command": "uvx",
"args": [
"gutfeel-mcp"
],
"env": {
"TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>",
"GUT_BACKEND": "<GUT_BACKEND>",
"GUT_MODEL": "<GUT_MODEL>",
"GUT_BASE_URL": "<GUT_BASE_URL>",
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gutfeel-mcp <команда>
Файл настроек
{
"servers": {
"gut": {
"type": "stdio",
"command": "uvx",
"args": [
"gutfeel-mcp"
],
"env": {
"TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>",
"GUT_BACKEND": "<GUT_BACKEND>",
"GUT_MODEL": "<GUT_MODEL>",
"GUT_BASE_URL": "<GUT_BASE_URL>",
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gutfeel-mcp <команда>
Командой платформы
gemini mcp add -e TYPESAFE_API_KEY=<TYPESAFE_API_KEY> -e GUT_BACKEND=<GUT_BACKEND> -e GUT_MODEL=<GUT_MODEL> -e GUT_BASE_URL=<GUT_BASE_URL> -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> gut uvx gutfeel-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gutfeel-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gut
Как установить gut в Claude Code?
Добавьте сервер командой claude mcp add gut -e TYPESAFE_API_KEY=<TYPESAFE_API_KEY> -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -- uvx gutfeel-mcp. Ключ нужен тот, под который настроен бэкенд.
Что делает gut?
Отвечает на оценочные вопросы вместо языковой модели: да или нет, какой из вариантов, насколько сильно. Ответ приходит вероятностями, а не текстом, поэтому его не надо разбирать.
Какие модели поддерживает gut?
Jev от TypeSafe AI — основная, но бэкенд настраивается: Jev через OpenRouter, локальная NLI-модель, небольшая LLM на своей машине или любой OpenAI-совместимый сервер вроде Ollama и vLLM.
