FastAPI-MCP

FastAPI-MCP 让你能够零配置地将现有 FastAPI 端点暴露为 Model Context Protocol (MCP) 工具，内置完整的认证支持。不同于其他 OpenAPI 到 MCP 的转换器，它是 FastAPI 原生实现。

核心功能

• 原生认证集成：使用现有的 FastAPI 依赖注入系统进行认证，无需额外配置
• FastAPI原生设计：不是简单的OpenAPI到MCP转换器，深度集成FastAPI
• 零/最小配置：只需指向你的FastAPI应用即可自动工作
• Schema保留：完整保留请求模型和响应模型的JSON Schema
• 文档保留：所有端点的文档与Swagger中显示的完全一致
• 灵活部署：支持将MCP服务器挂载到同一应用或单独部署
• ASGI传输：直接使用FastAPI的ASGI接口，性能优异

适用场景

• 将现有FastAPI服务快速暴露为MCP工具
• AI辅助API探索和集成测试
• 为现有API项目添加MCP协议支持
• 快速创建基于现有API的MCP服务器
• 企业内部API的AI代理接入

安装方式

前置要求：Python 3.10+、FastAPI、uv

pip install fastapi-mcp
# 或使用uv
uv add fastapi-mcp

MCP 客户端配置示例：

{
  "mcpServers": {
    "fastapi_mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/fastapi_mcp", "run", "mcp.py"],
      "timeout": 30000
    }
  }
}

许可证：MIT License