Starlette MCP SSE

Starlette MCP SSE

English | 简体中文

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

什么是 MCP？

模型上下文协议（MCP） 是一项开放标准，可让 AI 模型与外部工具和数据源交互。MCP 解决了 AI 开发中的多个关键问题：

• 上下文限制：允许模型访问训练数据之外的最新信息
• 工具集成：为模型使用外部工具和 API 提供标准化方式
• 互操作性：在不同的 AI 模型和工具之间建立通用接口
• 可扩展性：无需重新训练，即可轻松为 AI 系统添加新功能

本项目演示了如何在 Starlette Web 应用中使用服务器发送事件（SSE）实现 MCP。

描述

本项目演示了如何使用 Starlette 框架实现服务器发送事件（SSE），同时集成模型上下文协议（MCP）功能。其主要特点是在功能完备的 Starlette Web 应用中无缝集成 MCP 的 SSE 功能，并包含自定义路由。

功能

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

架构

本项目展示了一种模块化架构：

1. 将 MCP SSE 端点（/sse 和 /messages/）集成到 Starlette 应用中
2. 提供标准 Web 路由（/、/about、/status、/docs）
3. 演示如何将 MCP 功能与 Web 路由分离

安装与使用选项

前置条件

安装 UV 包管理器 —— 使用 Rust 编写的快速 Python 包安装程序：

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

选项 1：无需安装，快速运行

使用 UV 的执行工具，无需克隆仓库即可直接运行应用：

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

选项 2：完整安装

创建虚拟环境

为项目创建隔离的 Python 环境：

uv venv

激活虚拟环境

激活虚拟环境以使用它：

.venv\Scripts\activate

安装依赖项

安装所有必需的软件包：

uv pip install -r pyproject.toml

启动集成服务

启动集成的 Starlette 服务及 MCP SSE 功能：

python src/server.py

或

uv run start

可用端点

启动服务后（使用选项 1 或选项 2 均可），以下端点将可用：

• 主服务：http://localhost:8000
• 标准 Web 路由：
  • 主页：http://localhost:8000/
  • 关于页面：http://localhost:8000/about
  • 状态 API：http://localhost:8000/status
  • 文档：http://localhost:8000/docs
• MCP SSE 端点：
  • SSE 端点：http://localhost:8000/sse
  • 消息提交：http://localhost:8000/messages/

使用 MCP Inspector 调试

如需测试和调试 MCP 功能，请使用 MCP Inspector：

mcp dev ./src/weather.py

连接到 MCP Inspector

1. 在 http://localhost:5173 打开 MCP Inspector
2. 配置连接：
   • 将 Transport Type 设为 SSE
   • 输入 URL：http://localhost:8000/sse
   • 点击 Connect

测试功能

1. 转到 Tools 部分
2. 点击 List Tools 查看可用功能：
   • get_alerts：获取天气预警
   • get_forcast：获取天气预报
3. 选择一个功能
4. 输入所需参数
5. 点击 Run Tool 执行

扩展应用

添加自定义路由

应用结构便于添加新路由：

1. 在 routes.py 中定义新的路由处理程序
2. 将路由添加到 routes.py 的路由列表中
3. 主应用会自动包含这些路由

自定义 MCP 集成

MCP SSE 功能通过以下方式集成在 server.py 中：

• 创建 SSE 传输
• 设置 SSE 处理程序
• 将 MCP 路由添加到 Starlette 应用程序

与 Continue 集成

要将此 MCP 服务与 Continue VS Code 扩展搭配使用，请将以下配置添加到 Continue 设置中：

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