FastAPI MCP SSE

<p align="center"> <strong>English</strong> | <a href="/README.zh-CN.md">简体中文</a> </p>

这是一个使用FastAPI框架并集成模型上下文协议（MCP）的服务器发送事件（SSE）实现。

什么是MCP？

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

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

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

描述

本项目展示了如何使用FastAPI框架实现服务器发送事件（SSE），同时集成模型上下文协议（MCP）的功能。主要特点是将MCP的SSE能力无缝集成到一个完整的FastAPI网络应用中，该应用包括自定义路由。

特性

• 使用MCP实现服务器发送事件（SSE）
• 将FastAPI框架与自定义路由集成
• 统一的网络应用，包含MCP和标准网络端点
• 可定制的路由结构
• 清晰地分离MCP和网络功能的关注点

架构

本项目展示了一个模块化架构，它：

1. 将MCP SSE端点（/sse 和 /messages/）集成到FastAPI应用中
2. 提供标准网络路由（/，/about，/status，/docs，/redoc）
3. 展示如何维护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/

使用MCP Inspector调试

为了测试和调试MCP功能，请使用MCP Inspector：

mcp dev ./src/weather.py

连接到MCP Inspector

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

测试功能

1. 导航到工具部分
2. 点击列出工具查看可用函数：
   • get_alerts：获取天气警报
   • get_forcast：获取天气预报
3. 选择一个函数
4. 输入所需参数
5. 点击运行工具执行

扩展应用

添加自定义路由

应用结构使得使用FastAPI的APIRouter轻松添加新的路由：

1. 在routes.py中使用APIRouter定义新的路由处理器：

   @router.get("/new-route")
   async def new_route():
       return {"message": "这是一个新的路由"}
   

2. 使用路由器定义的所有路由将自动包含在主应用中

自定义MCP集成

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

• 创建一个SSE传输
• 设置SSE处理器
• 将MCP路由添加到FastAPI应用

与Continue集成

要使用此MCP服务器与Continue VS Code扩展一起工作，请在您的Continue设置中添加以下配置：

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