agentvet-mcp

@mukundakatta/agentvet용 MCP 서버. Claude Desktop, Cursor, Cline, Windsurf, Zed 또는 기타 MCP 클라이언트가 실행 전에 LLM이 생성한 도구 호출 인수를 검증하고, 문제가 발생했을 때 LLM 친화적인 재시도 메시지를 생성할 수 있도록 합니다.

npx -y @mukundakatta/agentvet-mcp

세 가지 도구:

• validate_tool_args — 작은 형태 사양(shape spec)에 따라 인수를 확인합니다. { valid, error?, retry_hint? }를 반환하며, 여기서 retry_hint는 LLM에 바로 보낼 수 있는 피드백 메시지입니다.

• lint_tool_definition — LLM의 도구 사용 정확도를 떨어뜨리는 일반적인 실수가 있는지 도구 정의를 검사합니다.

• generate_retry_message — 검증 오류가 주어지면, agentvet의 ToolArgError.toLLMFeedback() 형식을 사용하여 LLM 전용 재시도 메시지를 작성합니다.

클라이언트에 추가하기

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" } } }
  }
}

non-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 지원 AI 어시스턴트에서 사용할 수 있게 해줍니다. 도구 레지스트리를 빠르게 감사하거나, 채팅을 나가지 않고도 어시스턴트에게 "이 인수 객체가 내 send_email 도구에 유효한가요?"라고 묻는 데 유용합니다.

에이전트 루프 내에서 런타임 인수 검증을 수행하려면 Node 프로세스 내부에서 @mukundakatta/agentvet을 직접 사용하세요(도구 함수를 래핑하고 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