Github Q2w

🚀 基于 SSE 的 MCP 服务器和客户端示例 MCP

本项目展示了基于 Server-Sent Events (SSE) 的 MCP 服务器和独立 MCP 客户端工具的工作模式，为开发者提供了一种灵活、解耦的方式来使用 MCP 服务。其灵感来源于此处的原始讨论。

🚀 快速开始

环境准备

⚠️ 重要提示

请确保在 .env 文件或环境变量中提供 ANTHROPIC_API_KEY。

运行示例

以下是启动服务器和客户端的命令：

uv run weather.py
uv run client.py http://0.0.0.0:8080/sse

运行效果示例

Initialized SSE client...
Listing tools...

Connected to server with tools: ['get_alerts', 'get_forecast']

MCP Client Started!
Type your queries or 'quit' to exit.

Query: whats the weather like in Spokane?

I can help you check the weather forecast for Spokane, Washington. I'll use the get_forecast function, but I'll need to use Spokane's latitude and longitude coordinates.

Spokane, WA is located at approximately 47.6587° N, 117.4260° W.
[Calling tool get_forecast with args {'latitude': 47.6587, 'longitude': -117.426}]
Based on the current forecast for Spokane:

Right now it's sunny and cold with a temperature of 37°F and ...

✨ 主要特性

本项目的核心优势在于实现了 MCP 服务器和客户端的解耦。基于 SSE 的服务器和客户端可以作为独立的进程运行，甚至可以部署在不同的节点上。这与传统的 STDIO 模式不同，后者要求客户端作为子进程启动服务器。

📦 安装指南

通过 Smithery 自动安装

你可以通过 Smithery 自动安装基于 SSE 的 MCP 服务器和客户端：

npx -y @smithery/cli install @sidharthrajaram/mcp-sse --client claude

💻 使用示例

服务器

weather.py 是一个基于 SSE 的 MCP 服务器，它提供了一些基于国家气象局 API 的工具。该服务器改编自 MCP 文档中的 示例 STDIO 服务器实现。

默认情况下，服务器运行在 0.0.0.0:8080，你可以通过命令行参数进行配置：

uv run weather.py --host <your host> --port <your port>

客户端

client.py 是一个 MCP 客户端，用于连接并使用基于 SSE 的 MCP 服务器中的工具。它改编自 MCP 文档中的 示例 STDIO 客户端实现。

默认情况下，客户端通过命令行参数连接到 SSE 端点：

uv run client.py http://0.0.0.0:8080/sse