punkpeye/fastmcp

해결하는 문제

FastMCP는 Model Context Protocol (MCP) 서버를 구축하는 것을 간소화하기 위해 설계된 TypeScript 프레임워크입니다. 공식 SDK와 관련된 저수준의 반복 코드와 구현 복잡성을 제거하여, 개발자가 연결 처리, 응답 형식, 서버 구성 등을 수동으로 관리하지 않고도 도구, 리소스, 프롬프트의 핵심 기능에 집중할 수 있도록 합니다.

작동 방식

공식 MCP SDK 위에 구축된 FastMCP는 서버 기능을 정의하기 위한 명확한 고수준 API를 제공합니다. 표준 I/O(stdio), HTTP 스트리밍(SSE 호환)을 포함한 여러 전송 방식을 지원합니다. 개발자는 Zod, ArkType, Valibot 등의 스키마 검증 라이브러리를 사용하여 도구를 정의할 수 있습니다. 또한 Hono를 통합하여 사용자 정의 HTTP 경로를 추가할 수 있어, 서버가 MCP 서버이자 REST API 또는 웹훅 핸들러로도 작동할 수 있습니다.

대상 사용자

빠르게 MCP 서버를 구축하고 배포하고자 하는 TypeScript 개발자에게 적합합니다. 특히 Node.js, Bun, 또는 Cloudflare Workers, Deno Deploy와 같은 에지 런타임을 타겟으로 하는 경우에 유용하며, EdgeFastMCP 클래스를 통해 전용 지원이 제공됩니다.

주요 특징

• 간소화된 API: 최소한의 반복 코드로 도구, 리소스, 프롬프트를 빠르게 정의 가능.
• 유연한 전송 방식: stdio, HTTP 스트리밍, SSE를 지원하며, HTTPS를 통한 보안 연결도 가능.
• 에지 대응: Cloudflare Workers, Deno Deploy와 같은 에지 런타임에 전용 지원 제공. 서버리스 배포를 위한 상태 없는 모드 지원.
• 확장 가능한 HTTP: 통합된 Hono 앱을 사용해 사용자 정의 REST API 엔드포인트 및 웹훅 추가 가능.
• 개발자 도구: MCP Inspector를 통한 테스트 및 디버깅을 위한 CLI 포함.
• 스키마 독립성: Standard Schema 사양을 통해 다양한 검증 라이브러리와 호환 가능.