MCP Server Java Sse Http Demo

🚀 天気 Java SSE 伝送 MCP サービス

このプロジェクトは、Model Context Protocol (MCP) Java SDK を実装した実用的なサンプルです。Weather mcp - server とのやり取りを行うための fast - agent を含んでいます。

⚠️ 重要提示

このコードは本番環境向けではありません。主に、複数の MCP サーバー（ローカル Stdio 伝送とリモート HTTP SSE 伝送）を利用したエンドツーエンドの完全なソリューションの構築方法を示すことを目的としています。また、Spring フレームワークを過度に導入せず、Spring を使用したくないユーザーのニーズにも応えるようにしています。

デモでは、以下のような動作を確認できます。

1. エージェントは、大規模言語モデル（LLM）部分の処理に Claude Sonnet 3.7 を使用します。
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 実装