서버 인스펙터

MCP 서버를 구축할 때는 전체 애플리케이션에 연결하지 않고도 기능을 테스트할 방법이 필요합니다. Python MCP SDK에는 서버를 실시간으로 디버깅하고 테스트할 수 있는 브라우저 기반의 내장 인스펙터가 포함되어 있습니다.

인스펙터 시작하기

먼저 Python 환경이 활성화되어 있는지 확인하세요(정확한 명령어는 프로젝트의 README를 확인하세요). 그런 다음 다음 명령으로 인스펙터를 실행하세요:

mcp dev mcp_server.py

이렇게 하면 개발 서버가 시작되고 브라우저에서 인스펙터에 접근할 수 있는 로컬 URL(일반적으로 포트 6277)이 제공됩니다.

인스펙터 인터페이스 사용하기

MCP 인스펙터는 현재 활발히 개발 중이므로 사용 시 인터페이스가 다르게 보일 수 있습니다. 하지만 핵심 기능은 일관되게 유지됩니다.

"Connect"를 클릭하여 MCP 서버를 시작하면 다음 섹션들이 있는 내비게이션 바가 표시됩니다:

• Resources
• Prompts
• Tools
• 기타 서버 기능

도구 테스트하기

Tools 섹션은 디버깅 시간을 가장 많이 보내게 될 곳입니다. "List Tools"를 클릭하면 서버가 제공하는 모든 도구를 볼 수 있습니다.

도구를 선택하면 오른쪽 패널에 해당 도구의 세부 정보가 표시되고 테스트를 위한 입력 필드가 제공됩니다. 예를 들어 read_doc_contents 도구를 테스트하려면:

1. 목록에서 도구를 선택합니다
2. 문서 ID를 입력합니다(예: "deposition.md")
3. "Run Tool"을 클릭합니다
4. 성공 여부와 예상 출력을 확인합니다

도구 상호작용 테스트하기

여러 도구를 순서대로 테스트하여 서로 올바르게 작동하는지 확인할 수 있습니다. 예를 들어 edit_document 도구를 사용하여 콘텐츠를 수정한 후:

동일한 문서 ID로 read_doc_contents 도구를 다시 실행하여 변경 사항이 적용되었는지 확인하세요:

개발 워크플로우

인스펙터는 효율적인 개발 루프를 만들어줍니다:

• MCP 서버 코드를 변경합니다
• 다양한 입력으로 개별 도구를 테스트합니다
• 도구 상호작용이 예상대로 작동하는지 확인합니다
• 전체 애플리케이션 설정 없이 문제를 디버깅합니다

이 브라우저 기반 테스트 환경은 MCP 서버 개발에 필수적입니다. Claude나 다른 애플리케이션과 통합하기 전에 문제를 조기에 발견하고 기능을 검증할 수 있게 해주어 시간을 절약해 줍니다.