데브허브 | DEVHUB | Add MCP Server to Any FastAPI App in 5 MinutesAdd MCP Server to Any FastAPI App in 5 Minutes
fastapi-mcp 패키지를 사용하여 기존 FastAPI 앱에 MCP(Multi-Client Protocol) 서버 기능을 쉽게 추가할 수 있으며, 기존 API 코드를 변경할 필요가 없습니다. 🚀
- 이 패키지는 OpenAPI를 MCP로 변환하는 방식이 아닌, FastAPI에 최적화된 네이티브 솔루션입니다. ✨
pip install fastapi-mcp로 설치 후, FastAPIMCP를 임포트하고 인스턴스화한 다음, 모든 라우트 선언 후 mcp_mount()를 호출하여 마운트합니다. 🛠️
- FastAPI 라우트의
operation_id를 MCP 도구 이름으로 사용하며, 명시하지 않으면 자동으로 생성되므로 원하는 도구 이름을 위해 operation_id를 지정하는 것이 중요합니다. 🏷️
FastAPIMCP 인스턴스화 시 include 또는 exclude 파라미터를 사용하여 특정 operation_id를 가진 엔드포인트만 MCP 서버에 노출할 수 있습니다. 🔒
get_todos 라우트만 노출하여 Windf 클라이언트에서 할 일 목록을 성공적으로 조회했지만, 노출되지 않은 update 라우트는 사용할 수 없음을 보여주며 선택적 기능 추가의 유용성을 입증했습니다. 💡
- MCP 서버는 기본적으로
localhost:8000/mcp 경로를 통해 접근할 수 있습니다. 🌐