본문으로 건너뛰기
MCP 서버 전체 목록

FastAPI-MCP

  • 추천0
  • GitHub 별12K
  • 개발라이선스MIT

FastAPI 엔드포인트를 인증까지 그대로 살려 MCP 도구로 열어 주는 파이썬 라이브러리. 앱에 코드 두 줄이면 끝나요. MIT

원본:tadata-org/fastapi_mcp

설치 방법은 설치 탭에 정리했어요.

설명

fastapi-to-mcp

Tadata 제작

FastAPI-MCP

tadata-org/fastapi_mcp | Trendshift

FastAPI 엔드포인트를 인증까지 갖춘 Model Context Protocol(MCP) 도구로 열어 보세요!

PyPI 버전 지원하는 Python 버전 FastAPI CI 커버리지

fastapi-mcp-usage

기능

  • 기존 FastAPI 의존성을 그대로 쓰는 인증이 기본으로 들어 있습니다!

  • FastAPI 네이티브: 흔한 OpenAPI -> MCP 변환기가 아닙니다

  • 설정이 거의 필요 없음 - FastAPI 앱에 연결하기만 하면 동작합니다

  • 요청 모델과 응답 모델의 스키마를 그대로 보존합니다

  • Swagger에 있는 그대로, 모든 엔드포인트의 문서를 그대로 보존합니다

  • 유연한 배포 - MCP 서버를 같은 앱에 붙이거나 따로 배포할 수 있습니다

  • ASGI 전송 - FastAPI의 ASGI 인터페이스를 직접 써서 효율적으로 통신합니다

호스팅 서비스

관리형 호스팅 서비스를 원한다면 tadata.com을 확인하세요.

설치

빠른 파이썬 패키지 설치기인 uv를 쓰기를 권장합니다.

uv add fastapi-mcp

또는 pip로 설치할 수도 있습니다.

pip install fastapi-mcp

기본 사용법

FastAPI-MCP를 쓰는 가장 간단한 방법은 FastAPI 애플리케이션에 MCP 서버를 바로 붙이는 것입니다.

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP

app = FastAPI()

mcp = FastApiMCP(app)

# Mount the MCP server directly to your FastAPI app
mcp.mount()

이게 전부입니다! 자동으로 만들어진 MCP 서버를 https://app.base.url/mcp에서 쓸 수 있습니다.

문서, 예제, 고급 사용법

FastAPI-MCP는 상세한 문서를 제공합니다. 이 기능들이 실제로 쓰이는 코드 예시는 examples 폴더도 확인해 보세요.

FastAPI 우선 접근 방식

FastAPI-MCP는 API에서 MCP 도구를 만들어 내기만 하는 변환기가 아니라, FastAPI의 네이티브 확장으로 설계됐습니다. 이 접근 방식에는 몇 가지 큰 장점이 있습니다.

  • 네이티브 의존성: 인증과 권한 부여에 익숙한 FastAPI의 Depends()로 MCP 엔드포인트를 보호합니다

  • ASGI 전송: FastAPI의 ASGI 인터페이스로 앱과 직접 통신하므로 MCP에서 API로 HTTP 호출을 할 필요가 없습니다

  • 통합 인프라: FastAPI 앱을 MCP 서버와 따로 돌릴 필요가 없습니다(따로 배포하는 것도 지원합니다)

이 설계 철학 덕분에 기존 FastAPI 서비스에 MCP 기능을 더할 때 마찰이 최소로 줄어듭니다.

개발과 기여

FastAPI-MCP에 기여해 주셔서 감사합니다! 커뮤니티가 이슈를 올리고 풀 리퀘스트를 만들기를 환영합니다.

시작하기 전에 기여 가이드를 보세요.

커뮤니티

다른 MCP 애호가와 만나고, 질문하고, FastAPI-MCP 사용 경험을 나누려면 MCParty Slack 커뮤니티에 참여하세요.

요구 사항

  • Python 3.10 이상(3.12 권장)
  • uv

라이선스

MIT 라이선스. 저작권 (c) 2025 Tadata Inc.

저장소

tadata-org/fastapi_mcp