M

MCP 빌더

외부 API 및 서비스를 통합하는 고품질 MCP 서버 생성 가이드

What is it?

LLM이 잘 설계된 도구를 통해 외부 서비스와 상호 작용할 수 있게 하는 고품질 MCP(Model Context Protocol) 서버를 만들기 위한 종합 가이드입니다. MCP 서버는 LLM이 외부 서비스 및 API에 액세스할 수 있게 하는 도구를 제공합니다. 이 스킬은 Python(FastMCP) 및 Node/TypeScript(MCP SDK) 구현을 모두 다루며, 에이전트 중심 디자인 원칙과 평가 기반 개발에 중점을 둡니다.

How to use it?

개발은 구조화된 4단계 프로세스를 따릅니다:

1단계: 심층 연구 및 계획

  • 에이전트 중심 디자인 원칙 학습 (단순한 API 엔드포인트가 아닌 워크플로우를 위한 구축)
  • MCP 프로토콜 문서 가져오기 및 학습
  • 프레임워크 문서 로드 (Python SDK 또는 TypeScript SDK)
  • 대상 API 문서 철저히 학습
  • 종합적인 구현 계획 작성

2단계: 구현

  • 적절한 프로젝트 구조 설정
  • 핵심 인프라 구현 (API 헬퍼, 오류 처리, 포맷팅)
  • 적절한 입력 검증으로 도구 체계적으로 구현 (Pydantic/Zod)
  • 언어별 모범 사례 따르기
  • 도구 주석 추가 (readOnlyHint, destructiveHint 등)

3단계: 검토 및 개선

  • 코드 품질 검토 (DRY 원칙, 조합성, 일관성)
  • 테스트 및 빌드 (메인 프로세스 정지 방지)
  • 언어 가이드의 품질 체크리스트 사용

4단계: 평가 생성

  • 10개의 복잡하고 현실적인 평가 질문 작성
  • 질문이 독립적이고 읽기 전용이며 검증 가능한지 확인
  • 테스트를 위한 XML 평가 파일 생성

Key Features

  • 에이전트 중심 디자인 원칙 - 단순한 API 래퍼가 아닌 완전한 워크플로우를 위한 도구 구축
  • 컨텍스트 최적화 - 높은 신호 정보 반환, 데이터 덤프 방지
  • 실행 가능한 오류 메시지 - 에이전트를 올바른 사용으로 안내
  • Python(FastMCP) 및 TypeScript(MCP SDK) 모두 지원
  • 프로토콜 사양 및 모범 사례가 포함된 종합적인 문서 라이브러리
  • Pydantic v2(Python) 또는 Zod(TypeScript)를 사용한 입력 검증
  • 도구로 LLM 효과성 테스트를 위한 평가 하네스
  • 페이지네이션, 필터링, 문자 제한 전략
  • 프로덕션 준비 코드를 보장하는 품질 체크리스트
View on GitHub

GitHub Stats

Stars
Forks
Last Update
Author
Anthropic
License
Apache-2.0
Version
1.0.0

Categories

Features

⭐ Featured
💻 Code Execution