FastAPI-MCP
- 추천0
- GitHub 별12K
- 개발라이선스MIT
FastAPI 엔드포인트를 인증까지 그대로 살려 MCP 도구로 열어 주는 파이썬 라이브러리. 앱에 코드 두 줄이면 끝나요. MIT
설치 방법은 설치 탭에 정리했어요.
설명
Tadata 제작
FastAPI-MCP
FastAPI 엔드포인트를 인증까지 갖춘 Model Context Protocol(MCP) 도구로 열어 보세요!
기능
-
기존 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.