Fastapi MCP Sse

🚀 FastAPI MCP SSE 實現

本項目使用FastAPI框架實現了Server - Sent Events (SSE)，並集成了Model Context Protocol (MCP)功能，為AI模型與外部工具和數據源的交互提供了便利。

🚀 快速開始

本項目演示瞭如何在FastAPI框架中使用Server - Sent Events (SSE) 並集成Model Context Protocol (MCP) 功能。啟動服務器後，你可以通過不同端點訪問主服務器、標準網頁以及MCP SSE相關功能。

✨ 主要特性

• 帶有MCP的SSE實現。
• FastAPI框架與自定義路由的集成。
• 統一的網絡應用，同時具有MCP和標準網頁端點。
• 可定製的路由結構。
• MCP功能與網絡功能之間的職責分明。

📦 安裝指南

依賴項

安裝UV包管理器 - 一個用Rust編寫的快速Python包安裝工具：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

選項1：無需安裝的快速運行

直接使用UV執行工具運行應用：

uvx --from git+https://github.com/panz2018/fastapi_mcp_sse.git start

選項2：完整安裝

創建虛擬環境

為項目創建一個隔離的Python環境：

uv venv

激活虛擬環境

激活虛擬環境以使用它：

.venv\Scripts\activate

安裝依賴項

安裝所有所需的包：

uv pip install -r pyproject.toml

啟動集成服務器

啟動具有MCP SSE功能的FastAPI服務器：

python src/server.py

或

uv run start

💻 使用示例

可用端點

啟動服務器後（無論使用選項1還是選項2），將有以下端點可用：

• 主服務器：http://localhost:8000
• 標準網頁路由：
  • 主頁：http://localhost:8000/
  • 關於頁面：http://localhost:8000/about
  • 狀態API：http://localhost:8000/status
  • 文檔（Swagger UI）：http://localhost:8000/docs
  • 文檔（ReDoc）：http://localhost:8000/redoc
• MCP SSE端點：
  • SSE端點：http://localhost:8000/sse
  • 消息發佈：http://localhost:8000/messages/

使用Continue的集成

要將此MCP服務器與Continue VS Code擴展一起使用，請在Continue設置中添加以下配置：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "name": "weather",
          "type": "sse",
          "url": "http://localhost:8000/sse"
        }
      }
    ]
  }
}

🔧 技術細節

MCP 是什麼？

MCP（Model Context Protocol，模型上下文協議）是一項開放標準，使得AI模型能夠與外部工具和數據源交互。MCP解決了AI開發中的幾個關鍵挑戰：

• 上下文限制：允許模型訪問其訓練數據之外的最新信息。
• 工具集成：提供了一種標準化方式讓模型使用外部工具和API。
• 互操作性：創建了不同AI模型與工具之間的通用接口。
• 可擴展性：易於在AI系統中添加新功能而無需重新訓練。

架構

該項目展示了一個模塊化架構：

1. 將MCP SSE端點（/sse 和 /messages/）整合到FastAPI應用中。
2. 提供標準網頁路由（/, /about, /status, /docs, /redoc）。
3. 展示如何在MCP功能與網絡路由之間保持分離。