MCP 서버 빌더 가이드

무엇을 해주나

외부 API나 서비스를 LLM이 쓸 수 있게 감싸는 MCP(Model Context Protocol) 서버 제작을 4단계로 안내합니다.

• 1단계 리서치·설계: 개별 API 엔드포인트를 그대로 감싸지 말고, 여러 호출을 묶은 '워크플로 도구'(예: 가용성 확인 + 일정 생성을 합친 schedule_event)로 설계하도록 유도합니다. 제한된 컨텍스트에 맞춰 고신호 정보만 반환하고, concise/detailed 응답 옵션을 두도록 권합니다.
• 2단계 구현: 공용 유틸(요청 헬퍼, 에러 처리, 응답 포맷, 페이지네이션, 인증)을 먼저 만들고 도구를 하나씩 추가합니다. Python은 Pydantic, TypeScript는 Zod로 입력 스키마를 정의하고 readOnlyHint, destructiveHint, idempotentHint, openWorldHint 주석을 붙입니다.
• 3단계 리뷰: DRY, 조합 가능성, 일관성, 에러 처리, 타입 안전성, 문서화 기준으로 점검합니다.
• 4단계 평가 설계: 독립적·읽기 전용·다중 호출이 필요한 현실적 검증 질문을 만듭니다.

또한 MCP 공식 명세와 Python/TypeScript SDK README를 WebFetch로 불러와 최신 문법을 참고하게 합니다.

이런 분께 추천

• 사내 API를 Claude에 연결하려는 백엔드·플랫폼 개발자
• MCP 서버를 처음 만들어 구조와 순서를 잡고 싶은 분
• 이미 만든 MCP 서버의 도구 설계와 에러 메시지를 개선하려는 분

활용 예시

1. "우리 회사 티켓팅 REST API를 감싸는 MCP 서버를 Python FastMCP로 만들어줘" → 워크플로 도구 목록 설계 → Pydantic 스키마 → 공용 요청 헬퍼 순으로 구현.
2. "TypeScript SDK로 Notion 연동 MCP 서버를 만들고 도구 주석을 제대로 달아줘" → Zod 스키마와 readOnly/destructive 힌트가 포함된 코드 생성.
3. "방금 만든 MCP 서버가 실제로 쓸만한지 검증할 평가 질문 10개를 만들어줘" → 읽기 전용·다중 호출형 검증 세트 작성.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/composio-community/awesome-claude-plugins/HEAD/mcp-builder/skills/mcp-builder/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 composio-community/awesome-claude-plugins 의 mcp-builder/skills/mcp-builder 폴더를 내 ~/.claude/skills/composio-community-mcp-builder/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.