Install
npx @modelcontextprotocol/inspector누구에게 맞나
모델이 잘 설계된 도구로 외부 API나 서비스를 호출하도록 고품질 MCP(Model Context Protocol) 서버를 만들 때 mcp-builder를 사용한다. 언어는 Python(FastMCP) 또는 Node/TypeScript(MCP SDK)여도 된다. 구축 가이드이며 이름 없는 서버를 대신 호스팅하지 않는다.
더 알맞은 전제는 인터페이스를 바로 쓰지 않고 먼저 깊은 조사와 계획을 할 의향이 있다는 것이다. 자료는 TypeScript를 SDK 지원이 더 좋고 여러 실행 환경(예: MCPB)에서 호환성이 더 좋은 선택으로 쓴다. 자료는 에이전트 제품 목록이나 저장소 설치 경로를 주지 않는다. 공식 설명 페이지는
https://raw.githubusercontent.com/anthropics/skills/main/skills/mcp-builder/SKILL.md
3분 안에 첫 시도 끝내기
이 설명은 skill 설치 명령을 주지 않으므로 첫 시도에서 경로를 지어내지 말 것. 권장 경로는 1단계부터 시작한다: Deep Research and Planning. 고품질 MCP 서버에는 네 주요 단계가 있다. 발췌가 완전히 쓴 것은 1단계 제목뿐이므로 첫 시도는 계획만 하고 서버 프로세스는 쓰지 말 것.
전제: 붙일 외부 API 또는 서비스가 이미 있다. 저위험 동작: 해당 서비스의 어떤 질의가 읽기 전용이고 어떤 것이 데이터를 바꾸는지 나열하고, 원격은 Streamable HTTP를 쓰기로 정한다. 요약은 로컬에 stdio도 쓸 수 있다고 하지만 발췌는 원격 Streamable HTTP만 쓰므로 처음에 stdio 인수가 이미 다 쓰였다고 가정하지 말 것.
성공 신호: 한 장으로 「모델에 어떤 도구를 주고 입력에 어떤 제약을 쓸지」를 분명히 말할 수 있다. 먼저 npm init으로 계획 없는 프로젝트를 시작하지 말 것. 계획이 확인된 뒤에 구현으로 들어간다. TypeScript 쪽은 입력 schema에 Zod를 쓸 수 있다. 필드에는 제약과 분명한 설명이 필요하고 필드 설명에 예를 넣는다. 파일을 쓰기 전에 디렉터리를 확인한다.
사용 사례
사례 1: 권장 TypeScript 스택으로 원격 서버를 계획한다. MCP SDK를 고르고 전송은 Streamable HTTP, 입력은 Zod, 설명에 제약과 예를 넣는다. 요약은 outputSchema/structuredContent와 readOnlyHint, destructiveHint 같은 주석도 언급하지만 발췌는 이들 필드의 완전한 예를 쓰지 않는다. 이 사례의 완료 기준은 계획에서 읽기 전용 도구와 데이터를 바꾸는 도구를 나눈 것이며 모든 주석을 이미 채운 것이 아니다. Python 한 벌을 「주 경로」로 동시에 세우지 말 것. Python FastMCP와 Pydantic은 나란한 선택이지 이중 작성이 필수는 아니다.
사례 2: 구현 후 컴파일과 검사를 한다. TypeScript 경로는 먼저 npm run build로 컴파일이 되는지 확인한 뒤 MCP Inspector: npx @modelcontextprotocol/inspector. Inspector는 검사 화면을 열므로 부작용이 있다. 테스트 대상이 방금 구축한 로컬 또는 원격 서버인지 확인한 뒤 실행한다. 완료 기준은 build가 통과하고 Inspector가 지정한 서비스에 연결되는 것이다. 발췌는 Inspector의 모든 플래그를 쓰지 않으므로 연결 매개변수를 지어내지 말 것.
사용 경계
네 주요 단계는 깊은 조사와 계획에서 시작한다. 이후를 요약은 구현 후 검사·테스트로 스케치하지만 나머지 단계 제목은 발췌에서 펼치지 않는다. 원격 전송은 Streamable HTTP로 적혀 있다. 입력 schema는 Zod 또는 Pydantic. TypeScript 확인 명령은 npm run build와 공식 Inspector.
저장소 안 설치 경로를 지어내지 말 것. 자료는 클라이언트 목록도, 계획을 건너뛰고 바로 게시하는 방법도 쓰지 않는다. 여기에 적힌 단계, 언어 선택, 확인 명령을 넘는 범위는 이 설명이 다루지 않는다.