MCP 서버를 구축할 때는 전체 애플리케이션에 연결하지 않고도 기능을 테스트할 방법이 필요합니다. Python MCP SDK에는 서버를 실시간으로 디버깅하고 테스트할 수 있는 브라우저 기반의 내장 인스펙터가 포함되어 있습니다.
인스펙터 시작하기
먼저 Python 환경이 활성화되어 있는지 확인하세요(정확한 명령어는 프로젝트의 README를 참조하세요). 그런 다음 다음 명령으로 인스펙터를 실행합니다:
mcp dev mcp_server.py이렇게 하면 6277 포트에서 개발 서버가 시작되고 브라우저에서 열 수 있는 로컬 URL이 제공됩니다. 인스펙터 인터페이스가 로드되면서 MCP Inspector 대시보드가 표시됩니다.

인터페이스에 대한 중요 참고 사항
여기에 있는 이미지와 영상은 인스펙터 버전 1을 보여주지만, mcp dev는 이제 Node.js 22.19 이상이 필요한 버전 2를 시작합니다. 버전 2에서는 "Connect"를 클릭하는 대신 서버 카드에 있는 스위치를 켜며, Tools 탭에는 "List Tools" 버튼 없이 도구 목록이 표시되고, "Run Tool"은 "Execute Tool"이라는 이름으로 바뀝니다.
연결 및 도구 테스트
왼쪽에 있는 "Connect" 버튼을 클릭하여 MCP 서버를 시작하세요. 연결이 완료되면 Resources, Prompts, Tools 및 기타 기능을 위한 섹션이 있는 내비게이션 바가 표시됩니다.

도구를 테스트하려면:
- Tools 섹션으로 이동합니다
- "List Tools"를 클릭하여 사용 가능한 모든 도구를 확인합니다
- 테스트 인터페이스를 열 도구를 선택합니다
- 필요한 매개변수를 입력합니다
- "Run Tool"을 클릭하여 실행하고 결과를 확인합니다

문서 작업 테스트하기
예를 들어, 문서 읽기 도구를 테스트하려면 문서 ID(예: "deposition.md")를 입력하고 도구를 실행하면 됩니다. 인스펙터는 반환된 콘텐츠나 성공 메시지를 포함한 결과를 표시합니다.

작업을 연결하여 기능을 검증할 수 있습니다. 예를 들어, 텍스트를 교체하여 문서를 편집한 후 읽기 도구를 다시 실행하여 변경 사항이 올바르게 적용되었는지 즉시 확인할 수 있습니다.
개발 워크플로우
인스펙터는 효율적인 개발 루프를 만들어 줍니다:
- MCP 서버 코드를 변경합니다
- 인스펙터를 통해 개별 도구를 테스트합니다
- 전체 애플리케이션 설정 없이 결과를 검증합니다
- 문제를 독립적으로 디버깅합니다
더 복잡한 MCP 서버를 구축할수록 이 도구는 필수적인 존재가 됩니다. 기본적인 기능을 테스트하기 위해 서버를 Claude나 다른 애플리케이션에 연결할 필요가 없어지므로, 개발이 훨씬 빠르고 집중적으로 이루어집니다.