agentvet-mcp

MCP-сервер для @mukundakatta/agentvet. Позволяет Claude Desktop, Cursor, Cline, Windsurf, Zed или любому другому MCP-клиенту проверять аргументы вызова инструментов, сгенерированные LLM, перед их выполнением и создавать понятные для LLM сообщения для повторных попыток в случае возникновения ошибок.

npx -y @mukundakatta/agentvet-mcp

Три инструмента:

• validate_tool_args — проверяет аргументы на соответствие спецификации формы; возвращает { valid, error?, retry_hint? }, где retry_hint — это готовое к отправке сообщение с обратной связью для LLM.

• lint_tool_definition — выполняет проверку определения инструмента на наличие распространенных ошибок, которые снижают точность использования инструментов LLM.

• generate_retry_message — на основе ошибки валидации создает каноническое сообщение для повторной попытки, предназначенное для LLM, используя форматирование ToolArgError.toLLMFeedback() из agentvet.

Добавление в ваш клиент

Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "agentvet": {
      "command": "npx",
      "args": ["-y", "@mukundakatta/agentvet-mcp"]
    }
  }
}

Такая же структура используется для Cursor (~/.cursor/mcp.json), Cline, Windsurf, Zed.

Related MCP server: Echo MCP

Примеры инструментов

validate_tool_args:

{
  "tool_name": "send_email",
  "args": { "to": "a@b.com" },
  "shape": { "to": "string", "subject": "string", "body": "string" }
}

Возвращает:

{
  "valid": false,
  "error": "missing required field: subject",
  "retry_hint": "send_email rejected your args: missing required field: subject. Please call again with the corrected arguments."
}

lint_tool_definition:

{
  "tool": {
    "name": "BadName",
    "inputSchema": { "type": "object", "properties": { "x": { "type": "string" } } }
  }
}

Возвращает предупреждения об именах не в формате snake_case, отсутствии описания, отсутствии описаний полей и отсутствии обязательных полей.

generate_retry_message:

{
  "tool_name": "send_email",
  "validation_error": "missing required field: subject",
  "attempted_args": { "to": "a@b.com" }
}

Возвращает каноническую строку с обратной связью для повторной попытки, которую видят вызывающие стороны во время выполнения — таким образом, вы можете подготовить текст для повторной попытки вне активного цикла агента.

Зачем нужен отдельный MCP-сервер

@mukundakatta/agentvet — это JavaScript-библиотека без зависимостей. Этот MCP-сервер делает ее примитивы валидации доступными для любого ИИ-ассистента, поддерживающего MCP. Полезно для быстрой проверки реестра инструментов или для того, чтобы спросить ассистента: «Является ли этот объект аргументов допустимым для моего инструмента send_email?», не покидая чат.

Для валидации аргументов во время выполнения в цикле вашего агента используйте @mukundakatta/agentvet напрямую внутри вашего процесса Node (она оборачивает вашу функцию инструмента и синхронно выбрасывает ToolArgError).

Родственные MCP-серверы

Часть серии agent-stack:

• @mukundakatta/agentfit-mcp — Fit it. (Настройка)

• @mukundakatta/agentguard-mcp — Sandbox it. (Песочница)

• @mukundakatta/agentsnap-mcp — Test it. (Тестирование)

• @mukundakatta/agentvet-mcp — Vet it. (Проверка — этот сервер)

• @mukundakatta/agentcast-mcp — Validate it. (Валидация)

Лицензия

MIT