🚀 使用 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。