Starlette MCP Sse

🚀 使用 Starlette 框架實現的 MCP 服務器發送事件 (SSE)

本項目使用 Starlette 框架實現了服務器發送事件（SSE）功能，並集成了 模型上下文協議（MCP），為 AI 模型與外部工具和數據源的交互提供了便利。

🚀 快速開始

本項目展示瞭如何在 Starlette Web 應用程序中使用 SSE 實現 MCP。你可以按照以下步驟快速體驗：

1. 安裝 UV 包管理器 - 一個基於 Rust 的快速 Python 包安裝程序：

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

2. 直接運行以下命令：

uvicorn main:app --reload

3. 打開瀏覽器訪問 http://localhost:8000。

✨ 主要特性

• 使用 MCP 實現的服務器發送事件（SSE）。
• Starlette 框架集成，帶有自定義路由。
• 統一的 Web 應用程序，同時支持 MCP 和標準 Web 端點。
• 可自定義的路由結構。
• MCP 功能與 Web 功能之間的清晰職責分離。

📦 安裝指南

先決條件

安裝 UV 包管理器：

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

完整安裝步驟

1. 克隆倉庫：

git clone https://github.com/your-repository.git
cd your-repository

2. 創建虛擬環境並安裝依賴項：

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt

3. 啟動服務器：

uvicorn main:app --reload

💻 使用示例

基礎用法

訪問以下 URL 來測試功能：

• / - 默認主頁
• /sieve?n=1000 - 篩選素數的示例 API
• /about - 關於頁面
• /docs - API 文檔頁面

高級用法

添加自定義路由

在 Starlette 應用程序中添加新的路由，示例代碼如下：

from fastapi import FastAPI
from starlette.routing import Route, Router

app = FastAPI()

async def root(request):
    return "Hello, World!"

async def sieve(request):
    n = int(request.query_params.get("n", 100))
    primes = []
    for num in range(2, n+1):
        if all(num % i != 0 for i in primes):
            primes.append(num)
    return {"primes": primes}

app.add_route("/", root)
app.add_route("/sieve", sieve, methods=["GET"])

配置 Continue 插件

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

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

這將允許您在 Continue 中直接使用此 MCP 服務器提供的功能。

📚 詳細文檔

什麼是 MCP？

模型上下文協議 (MCP) 是一個開放標準，允許 AI 模型與外部工具和數據源進行交互。MCP 解決了 AI 開發中的幾個關鍵挑戰：

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

項目描述

該項目演示瞭如何在 Starlette 框架中實現服務器發送事件（SSE），同時集成 Model Context Protocol (MCP) 功能。其核心功能是將 MCP 的 SSE 功能與完整的 Starlette Web 應用程序無縫結合，該應用程序包含自定義路由。

架構

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

1. 將 MCP SSE 端點（/sse 和 /messages/）集成到 Starlette 應用程序中。
2. 提供標準 Web 路由（/, /about, /status, /docs）。
3. 展示瞭如何在 MCP 功能與 Web 路由之間保持分離。

使用 MCP Inspector 調試

要使用 MCP Inspector 調試，請運行以下命令：

python -m mcp_inspector server --config inspector_config.json

然後打開瀏覽器訪問 http://localhost:8091。