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