mcp-builder

외부 API나 서비스를 에이전트에 잇는 MCP 서버를 조사, 구현, 테스트, 평가 순서로 만들도록 이끄는 Anthropic 공식 스킬입니다.

스킬개발 흐름anthropics 제작 · 비공식 한국어 정리
설치 방법 보기원본 저장소

언제 쓰면 좋나

사내 API나 자주 쓰는 서비스를 에이전트가 직접 다루게 하려고 MCP 서버를 새로 만들 때 씁니다. 먼저 MCP 명세와 SDK 문서를 읽고 도구 이름, 오류 메시지, 결과 분량을 어떻게 설계할지 정한 뒤 TypeScript나 Python(FastMCP)으로 구현합니다. 마지막에는 실제 질문 10개로 평가 세트를 만들어 에이전트가 서버를 제대로 쓰는지 확인하는 단계까지 안내합니다.

설치

설치 전에 알아 둘 것

스킬 자체는 따로 준비할 것이 없습니다. 마지막 평가 단계의 스크립트를 돌리려면 Python, requirements.txt의 anthropic과 mcp 패키지, Anthropic API 키가 필요합니다.

아래 방법 중 하나만 따라 하면 됩니다.

아래 명령은 Claude Code 기준입니다. Codex, Cursor, Gemini CLI에서는 원본 저장소의 설치 안내를 따르세요.

방법 1 npx로 이 스킬만 설치

mcp-builder 하나만 설치됩니다.

  1. 터미널에서 실행
    npx skills add https://github.com/anthropics/skills --skill mcp-builder

방법 2 Claude Code 플러그인 (예제 스킬 묶음)

frontend-design, skill-creator 등 예제 스킬 묶음 전체가 함께 설치됩니다.

  1. Claude Code에서 입력
    /plugin marketplace add anthropics/skills
  2. Claude Code에서 입력
    /plugin install example-skills@anthropic-agent-skills

주의할 점

  • Anthropic이 시연과 교육용 예제라고 밝힌 스킬입니다. 중요한 작업에 쓰기 전에 직접 시험해 보라고 안내합니다.
  • Claude Code 플러그인으로 설치하면 mcp-builder 하나가 아니라 example-skills 묶음 전체(frontend-design, skill-creator 등)가 함께 들어옵니다. document-skills 플러그인까지 설치하면 같은 스킬이 두 번 올라온다는 이슈(#189)도 열려 있어서, 이 스킬만 필요하다면 npx 설치가 낫습니다.
  • 평가 단계의 스크립트는 Anthropic API를 직접 호출하므로 API 요금이 따로 들고, 기본 모델이 오래된 claude-3-7-sonnet으로 지정돼 있어 -m 옵션으로 지금 쓰는 모델을 지정해야 할 수 있습니다.
  • requirements.txt가 mcp 버전 상한을 두지 않아 mcp 2.x가 설치되면 평가 스크립트가 시작하자마자 실패합니다(#1742, 수정 대기). 고쳐지기 전에는 mcp 1.x로 고정해 두고, 평가 점수가 비정상적으로 0이면 #1390 문제를 먼저 의심하세요.
  • 구현 단계에서 MCP 명세와 SDK 문서를 웹에서 불러오므로 네트워크 접근과 웹 가져오기 권한이 필요합니다.

커뮤니티 반응

skills.sh에서 13만 회 넘게 설치될 만큼 많이 쓰이지만, 직접 만들어 본 후기는 찾기 어렵습니다. 저장소에서는 4단계 평가 스크립트가 실제 MCP 서버를 상대로 모든 도구 호출을 오류로 처리해 점수가 0이 된다는 이슈와, mcp 2.x에서 스크립트가 시작부터 실패한다는 수정 PR이 아직 열려 있습니다. HN에서는 예제 파이썬 코드의 stdio 연결 부분에 명령 주입 위험이 있다는 스캔 결과가 공유됐는데, 올린 사람도 점수는 믿기 어렵다고 덧붙였습니다.

다른 사용자들의 공개 후기를 요약했습니다(2026-10-27 확인).

비슷한 도구

mcp-builder 대신 쓸 만한 도구와 같은 개발 흐름 카테고리에서 별이 많은 도구입니다.