MCP Server Java Sse Http Demo

🚀 天氣 Java SSE 傳輸 MCP 服務

本項目是一個實現 Model Context Protocol (MCP) Java SDK 的工作示例，包含一個快速代理（fast-agent），用於與 Weather mcp-server 進行交互。它能幫助您瞭解如何構建一個完整的解決方案，利用多個 MCP 服務器（本地 Stdio 傳輸和遠程 HTTP SSE 傳輸）。

項目亮點

• 從頭到尾展示完整解決方案，利用多種 MCP 服務器。
• 避免引入過多 Spring 框架，滿足不希望使用 Spring 的用戶需求。

演示功能

在演示中，代理將完成以下操作：

1. 全程使用 Claude Sonnet 3.7 處理大語言模型（LLM）部分。
2. 調用 MCP 服務器上的 "fetch" 網絡搜索工具，查找每個輸入城市對應的經緯度。
3. 使用經緯度值調用天氣 MCP 服務器工具（本倉庫實現），終端窗口上半部分可查看調用詳細信息。
4. 總結各個城市的天氣預報，確定明天哪個城市最溫暖。

代理會根據用戶輸入提示的內容上下文，自動決定要調用哪些工具。

相關鏈接

• Model Context Protocol（MCP）
• Java SDK
• MCP 服務器列表

🚀 快速開始

✨ 主要特性

• 實現 MCP Java SDK 的工作示例，可與 Weather mcp-server 交互。
• 支持本地 Stdio 傳輸和遠程 HTTP SSE 傳輸。
• 自動根據用戶輸入上下文調用工具。

📦 安裝指南

構建和啟動 Weather MCP 服務器

mvn clean package
java -jar mcp-server/target/mcp-server-1.0-SNAPSHOT.jar

安裝、配置並啟動 fast-agent

安裝

pip install uv
uv pip install fast-agent-mcp
uv run agent.py

配置 Claude 和 OpenAI API 密鑰

複製模板文件並進行編輯：

cp fastagent.secrets.yaml.TEMPLATE fastagent.secrets.yaml

然後將您的 API 密鑰添加到該配置文件中。

注意：Weather MCP 服務器配置

在 fastagent.config.yaml 中，我們已經為代理指定了可用的 MCP 服務器。在此示例中，我們的服務器使用 SSE HTTP 傳輸，這使得能夠調用遠程 MCP 服務器：

mcp:
    servers:
        weather:
            transport: "sse"
            read_timeout_seconds: 10
            url: "http://localhost:8080/sse"

💻 使用示例

低級別測試

連接到 SSE 流

curl -v -H "Accept: text/event-stream" "http://localhost:8080/sse"

向 /mcp/messages 發送消息（注意：包含從 SSE 獲取的 sessionId）

curl -X POST "http://localhost:8080/mcp/message?sessionId=b64ad193-6bb3-4e2e-b33c-27a23011acb4" -d '{"hi": "mynameis"}' | jq .

📚 詳細文檔

參考資料

• youngsu5582 的 MCP 服務器 MySQL 實現

🔧 技術細節

本項目主要使用 Java 實現 MCP 服務器，使用 Python 實現 fast-agent。在整個過程中，使用 Claude Sonnet 3.7 處理大語言模型部分，並通過調用 MCP 服務器上的工具完成網絡搜索和天氣查詢等功能。

📄 許可證

文檔未提及相關內容，故跳過該章節。

常用提示信息

⚠️ 重要提示

這並不是生產級別的代碼，只是為了展示如何構建從頭到尾的完整解決方案，使其能夠利用多個 MCP 服務器（本地 Stdio 傳輸和遠程 HTTP SSE 傳輸）。此外，還避免引入過多的 Spring 框架，以滿足那些不希望使用 Spring 的用戶的需求。

💡 使用建議

在使用前，請確保已經正確配置 Claude 和 OpenAI API 密鑰，並按照文檔中的步驟進行安裝和配置。