Claude 같은 클라이언트가 여러 MCP 서버를 단일 HTTP 엔드포인트로 이용할 수 있게 집계하는 MCP 프록시 서버입니다.
punkpeye/fastmcp
클라이언트 세션을 처리하는 MCP 서버를 도구, 리소스, 프롬프트와 여러 전송 방식으로 구축하는 TypeScript 프레임워크입니다.
- 스타
- 3,278
- 포크
- 332
- 열린 이슈
- 5
- 마지막 커밋
- 10시간 전
어떤 프로젝트인가요?
FastMCP는 Model Context Protocol(MCP) 서버를 구축하기 위한 TypeScript 프레임워크입니다. 공식 MCP SDK를 감싸 서버 구성 요소 설정, 연결 관리, 도구·리소스·프롬프트 응답 형식 지정 같은 반복 작업을 처리하므로, 개발자는 몇 줄의 코드로 도구를 정의할 수 있습니다. 스키마는 Zod, ArkType, Valibot 또는 일반 JSON Schema로 작성할 수 있습니다.
서버는 stdio, SSE 호환 HTTP 스트리밍 또는 HTTPS로 실행할 수 있으며, stateful 또는 stateless 모드로 배포할 수 있습니다. 또한 기반이 되는 Hono 앱을 통해 인증, 헤더 및 세션 추적, 샘플링, 정보 요청(elicitation), roots, 진행 상황 알림, 사용자 지정 HTTP 라우트를 지원합니다. 엣지용 변형인 EdgeFastMCP는 Cloudflare Workers와 Deno Deploy를 대상으로 합니다.
이 프로젝트는 2025-11-25까지의 레거시 핸드셰이크 기반 MCP 개정판을 대상으로 하며, stateless 방식의 2026-07-28 사양은 지원하지 않습니다.
핵심 기능
- 01간단한 API로 도구, 리소스, 프롬프트를 정의합니다.
- 02Zod, ArkType, Valibot 또는 일반 JSON Schema로 매개변수를 검증합니다.
- 03stdio, SSE 호환 HTTP 스트리밍 또는 HTTPS로 서비스를 제공합니다.
- 04엣지 런타임을 포함해 stateful 또는 stateless 모드로 실행합니다.
- 05인증, 사용자 지정 Hono HTTP 라우트, 헬스 체크 엔드포인트를 추가합니다.
- 06인메모리 전송 방식, CLI 또는 MCP Inspector로 테스트합니다.
활용 사례
- LLM 클라이언트가 호출할 수 있는 도구로 내부 API나 데이터베이스를 감쌉니다.
- 클라이언트가 HTTP로 연결하는 원격 MCP 서버를 구축합니다.
- MCP 서버를 Cloudflare Workers 또는 Deno Deploy에 배포합니다.
- 네트워크 포트를 바인딩하지 않고 MCP 서버의 단위 테스트를 작성합니다.
빠른 시작
- 1
npm에서 fastmcp 패키지를 설치합니다
npm install fastmcp - 2
README의 Quickstart 코드를 사용해 서버 파일을 작성하고 server.start()로 시작합니다
사용 전 알아둘 점
- FastMCP는 레거시 핸드셰이크 기반 MCP 리비전(2025-11-25 및 이전 버전)만 지원하며, 현재의 상태 비저장 2026-07-28 사양은 지원하지 않습니다.
토픽
자주 묻는 질문
- fastmcp은(는) 무엇인가요?
- 클라이언트 세션을 처리하는 MCP 서버를 도구, 리소스, 프롬프트와 여러 전송 방식으로 구축하는 TypeScript 프레임워크입니다. FastMCP는 Model Context Protocol(MCP) 서버를 구축하기 위한 TypeScript 프레임워크입니다. 공식 MCP SDK를 감싸 서버 구성 요소 설정, 연결 관리, 도구·리소스·프롬프트 응답 형식 지정 같은 반복 작업을 처리하므로, 개발자는 몇 줄의 코드로 도구를 정의할 수 있습니다. 스키마는 Zod, ArkType, Valibot 또는 일반 JSON Schema로 작성할 수 있습니다.
- fastmcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- fastmcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- fastmcp은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. fastmcp의 마지막 커밋은 2026년 10월 22일입니다.
- fastmcp은(는) 어디에 사용할 수 있나요?
- LLM 클라이언트가 호출할 수 있는 도구로 내부 API나 데이터베이스를 감쌉니다. 클라이언트가 HTTP로 연결하는 원격 MCP 서버를 구축합니다. MCP 서버를 Cloudflare Workers 또는 Deno Deploy에 배포합니다. 네트워크 포트를 바인딩하지 않고 MCP 서버의 단위 테스트를 작성합니다.
- fastmcp는 어떻게 설치하나요?
- npm에서 fastmcp 패키지를 설치합니다: npm install fastmcp README의 Quickstart 코드를 사용해 서버 파일을 작성하고 server.start()로 시작합니다
- fastmcp은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/punkpeye/fastmcp
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
저사양 하드웨어에서 실행되며 다양한 LLM 제공업체와 채팅 앱에 연결되는 Go 기반 경량 개인 AI 비서입니다.
터미널에서 실행되며 클라우드 API와 Ollama 같은 로컬 모델 백엔드를 지원하는 오픈소스 코딩 에이전트 CLI입니다.
Claude나 ChatGPT 같은 LLM에 전달할 수 있도록 전체 코드 저장소를 하나의 AI 친화적인 파일로 묶는 CLI 및 웹 도구입니다.
Cloudflare에서 AI 앱을 구축하기 위한 TypeScript 패키지와 예제로, Vercel AI SDK와 TanStack AI용 provider를 제공합니다.
프롬프트를 다듬고 결과를 테스트·비교한 뒤 재사용 가능한 자산으로 저장하는 AI 프롬프트 최적화 도구로, 웹, 데스크톱, Chrome 확장 프로그램, Docker로 사용할 수 있습니다.