MCP 서버를 구축할 때는 전체 애플리케이션에 연결하지 않고도 기능을 테스트할 방법이 필요합니다. Python MCP SDK에는 서버를 실시간으로 디버깅하고 테스트할 수 있는 브라우저 기반 인스펙터가 내장되어 있습니다.
인스펙터 시작하기
먼저 Python 환경이 활성화되어 있는지 확인하세요(정확한 명령어는 프로젝트의 README를 확인하세요). 그런 다음 다음 명령으로 인스펙터를 실행하세요:
이렇게 하면 개발 서버가 시작되고 브라우저에서 인스펙터에 접근할 수 있는 로컬 URL(일반적으로 포트 6277)이 제공됩니다.
인스펙터 인터페이스 사용하기
MCP 인스펙터는 현재 활발히 개발 중이므로, 사용하실 때는 인터페이스가 다르게 보일 수 있습니다. 하지만 핵심 기능은 일관되게 유지됩니다.
인스펙터를 처음 열면 왼쪽에 "Connect" 버튼이 보입니다. 이 버튼을 클릭하여 MCP 서버를 시작하고 도구를 로드하세요.
도구 테스트하기
연결되면 Resources, Prompts, Tools와 같은 섹션이 있는 내비게이션 바를 찾으세요. Tools 섹션을 클릭하여 사용 가능한 도구를 확인하세요.
"List Tools"를 클릭하여 서버가 제공하는 모든 도구를 확인하세요. 특정 도구를 선택하면 오른쪽 패널이 업데이트되어 해당 도구를 테스트할 수 있는 폼이 표시됩니다.
도구 테스트 실행하기
예를 들어, 문서 읽기 도구를 테스트하려면:
read_doc_contents도구를 선택하세요- 문서 ID를 입력하세요(예: "deposition.md")
- "Run Tool"을 클릭하세요
인스펙터가 도구를 실행하고 성공 상태 및 반환된 데이터를 포함한 결과를 보여줍니다.
문서 편집 테스트하기
문서 편집과 같은 더 복잡한 도구도 테스트할 수 있습니다:
edit_document도구로 전환하세요- 문서 ID, 교체할 기존 텍스트, 새 텍스트를 입력하세요
- 도구를 실행하여 성공 여부를 확인하세요
- 읽기 도구를 다시 사용하여 변경 사항이 적용되었는지 확인하세요
개발 워크플로우
인스펙터는 왼쪽에 도구 호출 기록을 표시하여 테스트한 내용을 추적하고 이전 작업을 반복하기 쉽게 해줍니다. 이를 통해 다음과 같은 효율적인 개발 루프를 만들 수 있습니다:
- 서버 코드 변경하기
- 인스펙터 재시작하기
- 도구 즉시 테스트하기
- 결과 확인하기
이 인스펙터 도구는 더 복잡한 MCP 서버를 구축할 때 필수적인 도구가 됩니다. 기본 기능을 테스트하기 위해 서버를 전체 애플리케이션에 연결할 필요가 없어져, 개발이 훨씬 더 빠르고 안정적으로 이루어집니다.