MCP 툴 계약 검사기
MCP tools/list JSON과 OpenAI 함수 정의를 브라우저에서 분석합니다. 실제 호출 인수·structuredContent 예시를 검증하고 strict 모드 필수 조건과 미지원 키워드를 확인하세요.
이 도구는 무엇을 해주나요?
MCP 서버가 내보낸 tools/list 응답이나 OpenAI 함수 정의를 붙여넣고, 선언한 인수·출력 계약이 실제 예시 값과 맞는지 확인합니다. 일반적인 JSON Schema 조건과 OpenAI strict 모드의 문서화된 필수 조건을 분리해 보여줍니다. 서버 연결이나 AI 호출 없이 브라우저에서 분석합니다.
주요 기능
- MCP tools/list 응답, tools 배열, 단일 툴, OpenAI 함수 정의 읽기
- 필수 필드·타입·범위·enum·배열·중첩 객체·로컬 $ref 등 일반적인 제약 검사
- 예시 arguments와 MCP structuredContent를 입력해 호출 계약 점검
- OpenAI strict에 필요한 additionalProperties: false 및 모든 속성의 required 지정 확인
- 지원하지 않는 JSON Schema 키워드를 표시하고 유효한 MCP tools/call 요청 예시 제공
사용 방법
- MCP tools/list JSON이나 OpenAI function tools 배열을 붙여넣거나 .json 파일을 엽니다.
- 검사할 툴을 선택하고 정의 오류 및 strict 필수 조건을 확인합니다.
- 실제 호출 arguments를 입력해 스키마 제약과 충돌하는 필드를 찾습니다.
- outputSchema가 있다면 structuredContent 예시도 입력해 출력 계약을 확인합니다.
활용 예시
- MCP 서버를 배포하기 전 tools/list 정의와 샘플 호출 검사
- 에이전트가 반복해서 잘못된 인수로 도구를 호출하는 원인 찾기
- MCP 입력 스키마를 OpenAI strict 함수 호출에 맞게 옮길 때 기본 조건 확인
자주 묻는 질문
MCP 서버에 직접 연결하나요?
아니요. 붙여넣은 JSON 또는 로컬에서 선택한 .json 파일만 브라우저 안에서 검사합니다. 실제 서버 호출, 인증, 모델 호출은 수행하지 않습니다.
모든 JSON Schema 키워드를 검증하나요?
아닙니다. 이 도구는 툴 인수에서 흔히 쓰는 타입, 필수 필드, 열거값, 문자열·숫자 범위, 배열, 조합, 로컬 $ref 등을 검사합니다. 적용하지 않는 키워드는 경고로 표시하므로, 해당 경우에는 완전한 유효성 검사로 해석하면 안 됩니다.
strict 필수 조건을 통과하면 OpenAI API에서 반드시 동작하나요?
아니요. additionalProperties: false와 모든 properties 필드의 required 포함이라는 문서화된 필수 조건만 확인합니다. API의 전체 지원 스키마, 모델, 요청 설정까지 보증하지 않습니다.
outputSchema에는 어떤 예시를 넣나요?
MCP tools/call 응답 전체가 아니라 structuredContent 객체를 입력합니다. outputSchema가 없는 툴은 출력 예시 검사를 제공하지 않습니다.
관련 도구
- JSON Formatter & Validator — JSON 포맷팅 및 유효성 검사 (pretty/minify)
- XML Formatter & Validator — XML 포맷팅 및 유효성 검사 (pretty/minify)
- YAML Formatter & Validator — YAML 포맷팅 및 유효성 검사 (pretty/minify)
- 타임존 변환기 — 30+ 글로벌 도시 시간대 변환 · 다중 시간대 동시 비교
- Base64 Encode / Decode — Base64 인코딩과 디코딩을 빠르게 처리
- JWT Decoder — JWT 헤더/페이로드 디코딩