mcp-builder — Claude Code 스킬

고품질 MCP(Model Context Protocol) 서버를 만드는 가이드를 제공하는 Anthropic 공식 스킬. 잘 설계된 도구로 LLM이 외부 서비스와 상호작용하게 한다.

mcp-builder는 고품질 MCP(Model Context Protocol) 서버를 설계·구현하도록 안내하는 Anthropic 공식 Claude 스킬입니다. MCP는 LLM이 외부 서비스·데이터·도구와 표준화된 방식으로 상호작용하게 하는 개방형 프로토콜로, 클라이언트(Claude 등)와 서버 사이에서 도구(tool)·리소스(resource)·프롬프트를 노출합니다. 이 스킬은 "어떤 도구를 만들 것인가"보다 "도구를 LLM이 잘 쓰도록 어떻게 설계할 것인가"에 초점을 둡니다. 즉 명확한 도구 이름과 설명, 적절한 입력 스키마, 모델이 오해 없이 호출할 수 있는 파라미터 정의, 사람이 읽기 좋은 응답 형식, 에러 처리 같은 모범 사례를 따르도록 작업을 안내합니다.

해결하는 문제는 분명합니다. MCP 서버를 직접 만들다 보면 프로토콜 보일러플레이트, 도구 스키마 정의, 모호한 설명 때문에 모델이 도구를 잘못 호출하거나 호출하지 못하는 경우가 흔합니다. mcp-builder는 이런 함정을 줄이고, 잘 구조화된 서버 스캐폴드와 도구 설계 지침을 제공해 처음부터 일관된 품질로 작업하도록 돕습니다.

핵심 활용은 새 MCP 서버를 만들거나 기존 서버의 도구 정의·문서·구조를 다듬을 때입니다. 사내 API, SaaS, 데이터베이스, 검색 등 외부 기능을 Claude가 호출 가능한 도구로 노출하려는 개발자에게 적합합니다. 이미 공개된 시간(time)·깃(git)·데이터베이스·검색 계열 MCP 서버들의 설계를 참고 모델로 삼을 수 있습니다. 다만 구체적 API 사양·SDK 버전·전송 방식(stdio, HTTP 등)은 변동될 수 있으므로 실제 구현 시에는 출처의 공식 MCP 문서와 SDK를 함께 확인하는 것을 권장합니다.

언제 쓰나

새로운 MCP 서버를 처음부터 만들 때, 또는 기존 서버의 도구(tool) 정의·입력 스키마·설명·응답 형식을 LLM 친화적으로 다듬어 호출 정확도를 높이고 싶을 때 적합합니다. 사내 API·SaaS·DB·검색 기능을 Claude가 부를 수 있는 도구로 노출하려는 개발자에게 유용합니다. 단순 단발 스크립트나 프로토콜 학습 없이 끝나는 일에는 과합니다.

설치

/plugin marketplace add anthropics/skills 후 /plugin install example-skills@anthropic-agent-skills

Claude Code에서 플러그인 마켓플레이스(anthropics/skills)를 추가한 뒤 example-skills 플러그인을 설치하면 mcp-builder 스킬이 활성화됩니다(구체 명령은 별도 표시). 별도 환경변수는 요구하지 않습니다. 스킬은 서버 제작 가이드일 뿐, MCP 자체의 런타임·SDK(Python/TypeScript 등)·전송 방식 선택은 사용자 환경에 따라 달라지므로 실제 구현·배포 전제는 출처의 공식 MCP 문서와 해당 SDK 버전을 함께 확인하는 것을 권장합니다.

보안 주의

이 스킬 자체는 가이드라 별도 비밀키를 요구하지 않습니다(env 없음). 그러나 만드는 MCP 서버는 외부 서비스에 연결되므로 위험이 거기로 옮겨갑니다. 서버가 다루는 API 키·토큰·DB 자격증명은 코드·로그·스킬 출력에 노출하지 말고 환경변수/시크릿 저장소로 분리하세요. 쓰기·삭제·결제·배포 같은 파괴적 도구를 노출할 때는 최소 권한·범위 제한·확인 절차를 두는 것이 안전합니다. 또한 도구가 반환하는 외부 콘텐츠나 설명 문자열에 프롬프트 인젝션이 섞여 모델 행동을 조작할 수 있으니, 외부 입력을 신뢰하지 말고 검증·격리하는 설계를 권장합니다.

자주 묻는 질문

mcp-builder는 MCP 서버를 자동으로 완성해 주나요?

완전 자동 생성기라기보다, 고품질 MCP 서버를 설계·구현하도록 안내하는 가이드 스킬입니다. 도구 이름·설명·입력 스키마·응답 형식 등 모범 사례를 따르도록 작업을 이끌어 처음부터 일관된 품질로 만들도록 돕습니다. 구체 구현은 사용자의 코드와 SDK 위에서 이뤄집니다.

왜 도구 설계 품질이 중요한가요?

MCP에서 LLM은 도구의 이름과 설명, 입력 스키마만 보고 언제·어떻게 호출할지 판단합니다. 설명이 모호하거나 스키마가 부정확하면 모델이 도구를 잘못 부르거나 아예 못 부릅니다. mcp-builder는 이런 호출 정확도를 높이는 설계에 초점을 둡니다.

어떤 언어나 SDK로 MCP 서버를 만들어야 하나요?

MCP는 여러 공식 SDK(예: Python, TypeScript)와 전송 방식을 지원하지만, 권장 스택과 버전·옵션은 변동될 수 있습니다. 실제 구현 전 출처의 공식 MCP 문서와 해당 SDK 문서를 확인하는 것을 권장합니다.