开源项目 fastapi_mcp 的扩展与二次开发潜力

开源项目 fastapi_mcp 的扩展与二次开发潜力

项目的基础介绍

fastapi_mcp 是一个开源项目，旨在为 FastAPI 应用程序自动暴露端点作为 Model Context Protocol (MCP) 工具提供零配置的工具。它允许开发者在不需要进行复杂配置的情况下，将 FastAPI 应用程序中的端点转换为 MCP 工具，从而便于模型的使用和集成。

项目的核心功能

• 直接集成：可以直接将 MCP 服务器挂载到 FastAPI 应用程序上。
• 零配置：只需要指向 FastAPI 应用程序，即可自动工作。
• 自动发现：自动发现所有 FastAPI 端点并将其转换为 MCP 工具。
• 保留架构：保留请求模型和响应模型的架构。
• 保留文档：保留所有端点的文档，如同在 Swagger 中一样。
• 灵活部署：可以将 MCP 服务器挂载到同一应用程序上，也可以独立部署。

项目使用了哪些框架或库？

项目主要使用了以下框架或库：

• FastAPI：用于构建 API 的现代、快速（高性能）的 Web 框架，使用 Python 3.6 及以上版本编写。
• uvicorn：一个 ASGI 服务器，用于运行 FastAPI 应用程序。

项目的代码目录及介绍

项目的代码目录结构如下：

fastapi_mcp/
├── examples/             # 示例代码目录
├── fastapi_mcp/          # 主程序代码
│   ├── __init__.py
│   ├── __main__.py
│   ├── MCPManager.py
│   ├── MCPTools.py
│   └── server.py
├── tests/                # 单元测试代码
│   ├── __init__.py
│   └── test_main.py
├── .github/              # GitHub 相关配置
│   ├── workflows/
│   └── ...
├── ...
├── README.md             # 项目说明文件
├── README_zh-CN.md       # 项目说明文件（中文）
└── ...

• examples/：包含项目的示例代码，可以参考这些示例来了解如何使用 fastapi_mcp。
• fastapi_mcp/：项目的主代码目录，包含项目的核心逻辑和功能实现。
• tests/：包含项目的单元测试代码，确保代码质量和功能的正确性。
• .github/：包含 GitHub 相关的配置文件和自动化工作流程。

对项目进行扩展或者二次开发的方向

1. 自定义工具命名：为 FastAPI 路由定义明确的 operation_id，以便生成更直观的 MCP 工具名称。
2. 自定义架构描述：扩展项目以允许更详细的架构描述，包括响应架构的全面描述。
3. 端点筛选功能：增强项目的端点筛选功能，允许更灵活地包含或排除特定的端点或标签。
4. 独立部署支持：改进项目的独立部署功能，使其更加易于在不同环境中部署和使用。
5. 性能优化：对项目进行性能分析和优化，提高其在生产环境中的性能表现。
6. 社区和文档建设：完善项目文档，增加社区支持，促进项目的进一步发展和完善。