Repolode
punkpeye

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. 1

    npm에서 fastmcp 패키지를 설치합니다

    npm install fastmcp
  2. 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 통계는 매일 갱신됩니다.

관련 프로젝트