fastmcp

FastMCP 🚀
빠르게 움직이고, 무언가를 만들어라.

Prefect가 💙을 담아 만들었습니다.

MCP(Model Context Protocol)는 LLM을 도구 및 데이터와 연결합니다. FastMCP는 서버, 클라이언트, 인터랙티브 앱을 위한 완전한 MCP 애플리케이션 프레임워크입니다. 서버는 평범한 Python으로 시작합니다:

from fastmcp import FastMCP

mcp = FastMCP ( "Demo 🚀" )

@ mcp . tool
def add ( a : int , b : int ) -> int :
"""Add two numbers"""
return a + b

if __name__ == "__main__" :
mcp . run ()
FastMCP를 사용하는 이유
효과적인 MCP 애플리케이션을 구축하는 것은 보기보다 어렵습니다. FastMCP는 이 모든 것을 처리합니다. Python 함수로 도구를 선언하면 스키마, 검증, 문서가 자동으로 생성됩니다. URL로 서버에 연결하면 전송 협상, 인증, 프로토콜 수명 주기가 알아서 관리됩니다. 여러분은 로직에 집중하면 되고, MCP 부분은 그냥 작동합니다. FastMCP에서는 모범 사례가 기본으로 내장되어 있습니다.

그래서 FastMCP가 MCP 작업의 표준 프레임워크입니다. FastMCP 1.0은 2024년에 공식 MCP Python SDK에 통합되었습니다. 오늘날 활발히 유지 관리되는 독립형 프로젝트는 하루에 백만 번 다운로드되며, 모든 언어에 걸쳐 MCP 서버의 70%가 어떤 형태로든 FastMCP로 구동됩니다.

FastMCP에는 세 가지 기둥이 있습니다:

Servers

LLM에 도구, 리소스, 프롬프트를 노출합니다.

Apps

도구에 대화 내에서 직접 렌더링되는 인터랙티브 UI를 제공합니다.

Clients

로컬이든 원격이든, 프로그래밍 방식이든 CLI든 모든 MCP 서버에 연결합니다.

Servers는 Python 함수를 MCP 규격에 맞는 도구, 리소스, 프롬프트로 감쌉니다. Clients는 완전한 프로토콜 지원으로 모든 서버에 연결합니다. 그리고 Apps는 도구에 대화 내에서 직접 렌더링되는 인터랙티브 UI를 제공합니다.

TypeScript로 개발 중이신가요? FastMCP for TypeScript는 동일한 팀이 만들고 유지 관리하는 공식 대응 버전입니다. 같은 기둥, 같은 아이디어, npm install @prefecthq/fastmcp-ts .

빌드할 준비가 되셨나요? 설치 가이드 로 시작하거나 바로 퀵스타트 로 이동하세요.

Horizon으로 MCP 확장하기
FastMCP는 MCP 애플리케이션 계층을 처리합니다. Prefect Horizon은 팀 전반에 걸쳐 서버와 도구를 확장하기 위한 엔터프라이즈 MCP 게이트웨이로, 배포, 검색, 보안, 사용 방식에 대한 중앙 집중식 거버넌스를 제공합니다.

FastMCP와 Horizon은 Prefect 의 동일한 팀이 만듭니다.

GitHub에서 FastMCP 서버를 배포하고 브랜치 프리뷰와 즉각적인 롤백을 사용하세요. 회사에서 사용하는 모든 MCP의 프라이빗 레지스트리를 만드세요. SSO와 도구 수준 RBAC로 액세스를 보호하세요. MCP 스택 전반에 걸쳐 감사 로그, 관측성, 거버넌스를 확보하세요. 승인된 도구를 팀과 에이전트를 위한 목적별 엔드포인트로 리믹스하세요.

FastMCP로 시작하고, Horizon으로 확장하세요 →

설치
uv 를 사용하여 프로젝트에 FastMCP를 추가하는 것을 권장합니다:

uv add fastmcp
검증 및 업그레이드를 포함한 전체 설치 지침은 설치 가이드 를 참조하세요.

업그레이드하시나요? 다음에 대한 가이드가 있습니다:

FastMCP 3에서 업그레이드
FastMCP 2에서 업그레이드
MCP SDK v1 또는 v2에서 업그레이드
저수준 SDK v1 또는 v2에서 업그레이드

📚 문서
FastMCP의 전체 문서는 gofastmcp.com 에서 확인할 수 있으며, 상세한 가이드, API 레퍼런스, 고급 패턴을 포함합니다.

문서는 LLM이 쉽게 소비할 수 있는 간단한 마크다운 표준인 llms.txt 형식 으로도 제공됩니다:

llms.txt는 기본적으로 사이트맵으로, 문서의 모든 페이지를 나열합니다.
llms-full.txt는 전체 문서를 포함합니다. 이는 LLM의 컨텍스트 윈도우를 초과할 수 있습니다.

코딩 에이전트에게 llms.txt를 시작점으로 제공하세요. 버전에 맞는 문서와 선택적 서버 작성 스킬은 Coding Agents 를 참조하세요.

커뮤니티: Discord 서버 에 참여하여 다른 FastMCP 개발자들과 연결하고 무엇을 만들고 있는지 공유하세요.

기여
수락되는 기여와 이슈 할당 워크플로는 CONTRIBUTING.md 로 시작한 후, 설정 및 검증을 위해 Contributing Guide 를 따르세요. 에이전트는 AGENTS.md 를 읽어야 합니다.