Awesome MCP Fastapi

🚀 MCP FastAPI 優秀項目

本項目是一個基於 FastAPI 的強大 Model Context Protocol (MCP) 實現，結合增強工具註冊表功能，充分利用了成熟的 FastAPI 生態系統，為相關開發提供了高效、便捷的解決方案。

🚀 快速開始

先決條件

• Python 3.10+

安裝

# 克隆倉庫
git clone https://github.com/yourusername/awesome-mcp-fastapi.git
cd awesome-mcp-fastapi

# 創建虛擬環境
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安裝依賴項
pip install -e .

運行服務器

uvicorn src.main:app --reload

訪問 http://localhost:8000/docs 查看 OpenAPI 文檔。

✨ 主要特性

比標準 MCP 更具優勢

儘管 Model Context Protocol 提供了連接 AI 模型與工具和數據源的良好基礎，但本項目的實現提供了幾個顯著優勢：

FastAPI 的成熟生態系統

• 生產就緒的 Web 框架：基於 FastAPI，一個高性能、現代的 Web 框架，帶有自動 OpenAPI 文檔生成。
• 依賴注入支持：利用 FastAPI 強大的依賴注入系統實現更易維護和測試的代碼。
• 中間件支持：輕鬆集成身份驗證、監控和其他中間件組件。
• 內置驗證：通過 Pydantic 實現強大的請求/響應驗證和數據建模。
• 異步支持：對 async/await 模式的頂級支持，適合高併發應用。

增強的工具註冊表

本項目的實現通過以下方式改進了標準 MCP 工具註冊表：

• 自動文檔生成：工具會自動生成 MCP 格式和 OpenAPI 規範的文檔。
• 改進的類型提示：增強的類型信息提取，提升工具支持和 IDE 體驗。
• 更豐富的模式定義：更具表達性的 JSON Schema 定義工具輸入和輸出。
• 更好的錯誤處理：結構化的錯誤響應，帶有詳細的信息。
• 增強的文檔字符串支持：更好地從 Python 文檔字符串中提取信息。

額外功能

• CORS 支持：準備支持跨域請求，便於與 Web 應用程序集成。
• 生命週期管理：通過 FastAPI 的生命週期 API 實現資源的初始化和清理。

💻 使用示例

基礎用法

創建工具

from fastapi import FastAPI
from src.utils.tools import create_tool

app = FastAPI()
my_tool = create_tool(...)
app.include_router(my_tool.router)

請求格式

發送 POST 請求到 /tools/your-tool-id，請求體如下：

{
  "inputs": {
    "param1": "value1",
    "param2": "value2"
  },
  "options": {
    "timeout": 3000,
    "some_option": true
  }
}

📚 詳細文檔

架構

項目使用模塊化架構：

• app：主應用入口。
• tools：工具定義和註冊。
• routers：路由配置。
• models：數據模型和驗證。

awesome-mcp-fastapi/
├── app.py
├── models/
│   └── __init__.py
├── routers/
│   └── __init__.py
└── tools/
    └── __init__.py

Docker 支持

構建和運行：

docker build -t awesome-mcp-fastapi .
docker run -p 8000:8000 --env-file .env awesome-mcp-fastapi

🤝 貢獻

歡迎貢獻！請隨時提交 Pull Request。

📄 許可證

本項目在 MIT License 下許可，詳情請參見 LICENSE 文件。