天气 Java SSE 传输 MCP 服务

一个实现 Model Context Protocol (MCP) Java SDK 的工作示例。包含了一个快速代理（fast-agent），用于与 Weather mcp-server 进行交互。

⚠️ 这并不是生产级别的代码，只是为了展示如何构建从头到尾的完整解决方案，使其能够利用多个 MCP 服务器（本地 Stdio 传输和远程 HTTP SSE 传输）。此外，还避免引入过多的 Spring 框架，以满足那些不希望使用 Spring 的用户的需求。

在演示中，您将看到代理：

1. 该代理在整个过程中都使用 Claude Sonnet 3.7 来处理大语言模型（LLM）部分
2. 该代理调用 MCP 服务器上的 "fetch" 网络搜索工具来查找每个输入城市对应的经纬度。
3. 该代理随后使用这些经纬度值来调用天气 MCP 服务器工具（在本仓库中实现的）。您可以在终端窗口上半部分看到调用的详细信息。
4. 该代理总结各个城市的天气预报，并确定明天哪个城市最温暖。

代理会根据用户输入提示的内容上下文，自动决定要调用哪些工具。

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

构建和启动 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 实现