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

这是一个基于 SSE（Server-Sent Events）的 MCP 服务器和独立 MCP 客户端的工作模式示例，为相关开发提供了清晰的参考。它参考了最初的讨论 here。

🚀 快速开始

✨ 主要特性

本项目的主要特性在于展示了基于 SSE 的 MCP 服务器和客户端的工作模式，使得 MCP 服务器可以独立运行，客户端能在任意时间和位置连接，更适合“云原生”用例。

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 SSE 基于的 MCP 服务器和客户端，可使用以下命令：

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

💻 使用示例

基础用法

注意：请确保在 .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 ...

🔧 技术细节

服务器

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

📚 详细文档

本项目的工作模式意味着 MCP 服务器现在可以是一个独立运行的进程，客户端可以在任何时间、任何位置连接到它。与基于 STDIO 模式的客户端（其中客户端本身会启动一个子进程作为服务器）相比，这是一种不同的模式，并且更适合“云原生”用例。