使用 Starlette 框架实现的 MCP 服务器发送事件 (SSE)

English | 简体中文

一个使用 Starlette 框架实现的服务器发送事件（SSE）功能，并集成了 模型上下文协议（MCP）。

什么是 MCP？

模型上下文协议 (MCP) 是一个开放标准，允许 AI 模型与外部工具和数据源进行交互。MCP 解决了 AI 开发中的几个关键挑战：

• 上下文限制：允许模型访问其训练数据之外的最新信息
• 工具集成：提供了一种标准化方式供模型使用外部工具和 API
• 互操作性：创建了一个不同 AI 模型和工具之间的通用接口
• 可扩展性：使添加新功能到 AI 系统变得简单，而无需重新训练

该项目展示了如何在 Starlette Web 应用程序中使用 SSE 实现 MCP。

项目描述

该项目演示了如何在 Starlette 框架中实现服务器发送事件（SSE），同时集成 Model Context Protocol (MCP) 功能。其核心功能是将 MCP 的 SSE 功能与完整的 Starlette Web 应用程序无缝结合，该应用程序包含自定义路由。

特性

• 使用 MCP 实现的服务器发送事件（SSE）
• Starlette 框架集成，带有自定义路由
• 统一的 Web 应用程序，同时支持 MCP 和标准 Web 端点
• 可自定义的路由结构
• MCP 功能与 Web 功能之间的清晰职责分离

架构

该项目展示了一个模块化的架构，该架构：

1. 将 MCP SSE 端点（/sse 和 /messages/）集成到 Starlette 应用程序中
2. 提供标准 Web 路由（/, /about, /status, /docs）
3. 展示了如何在 MCP 功能与 Web 路由之间保持分离

安装与使用选项

先决条件

安装 UV 包管理器 - 一个快速的 Python 包安装程序，基于 Rust：

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

快速运行

直接运行以下命令：

uvicorn main:app --reload

然后打开浏览器访问 http://localhost:8000。

完整安装

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 文档页面

使用 MCP Inspector 调试

要使用 MCP Inspector 调试，请运行以下命令：

python -m mcp_inspector server --config inspector_config.json

然后打开浏览器访问 http://localhost:8091。

扩展应用

添加自定义路由

在 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 服务器提供的功能。