Modelcontextprotocolclient

🚀 ModelContextProtocolClient

このアプリケーションはSpring Bootベースのクライアントアプリで、WebFlux SSEやStdioなどの様々な伝送方法を用いてMCPサーバーと通信するデモを提供します。

🚀 クイックスタート

📦 インストール

環境設定

1. プロジェクトのルートディレクトリに.envファイルを作成し、以下の内容を追加します。

BRAVE_SEARCH_API_KEY=あなたのBrave検索APIキー
WEATHER_API_KEY=あなたの天気APIキー

2. リポジトリをクローンします。

git clone https://github.com/InnoBridge/ModelContextProtocolServer

3. Docker環境を設定します。

   1. docker-compose.ymlのボリュームマッピングを更新します。

    modelcontextprotocolclient_application
    ...
   volumes:
     - .:/app
     - /var/run/docker.sock:/var/run/docker.sock
     - ./local/root:/root
     - ../{ModelContextProtocolServerのパス}:/ModelContextProtocolServer
   

   2. Dockerコンテナを起動します。

   sudo docker compose up
   

   3. MCPサーバーを構築して実行します。

   # 新しいターミナルウィンドウで
   sudo docker exec -it modelcontextprotocolserver-application sh
   cd /app
   ./mvnw clean install
   ./mvnw spring-boot:run
   

   4. クライアントを構築して実行します。

   # 別の新しいターミナルウィンドウで
   docker exec -it modelcontextprotocolclient-application sh
   ./mvnw spring-boot:run
   

💻 使用例

利用可能なエンドポイント

WebFlux伝送

• GET /webflux/tools - 利用可能なすべてのツールをリストします。
• POST /webflux/calculate - 計算機ツールを使用して計算を行います。

  curl -X POST "http://localhost:8080/webflux/calculate?operation=add&a=5&b=3"
  

• POST /webflux/weather - 天気情報を取得します。

  curl -X POST "http://localhost:8080/webflux/weather?location=San%20Francisco&format=celsius"
  

Stdio伝送

• GET /stdio/tools - 利用可能なすべてのツールをリストします。
• POST /stdio/calculate - 計算機ツールを使用して計算を行います。

  curl -X POST "http://localhost:8080/stdio/calculate?operation=add&a=5&b=3"
  

• POST /stdio/weather - 天気情報を取得します。

  curl -X POST "http://localhost:8080/stdio/weather?location=San%20Francisco&format=celsius"
  

BraveSearch伝送

• GET /tools/bravesearch - 利用可能なツールをリストします。
• POST /bravesearch - ウェブ検索を実行します。

  curl -X POST "http://localhost:8080/bravesearch?query=spring%20boot"
  

🔧 技術詳細

設定

このアプリケーションは、以下の様々な伝送設定をサポートしています。

1. WebFlux SSE伝送（デフォルト）

   • Server-Sent Eventsを使用してサーバーと通信します。
   • サーバーはWebFluxモードで実行する必要があります。

2. Stdio伝送

   • 標準入出力を使用してサーバーと通信します。
   • サーバーのJARファイルを自動的に起動し、stdioモードで実行します。

3. BraveSearch伝送

   • BraveSearch APIを使用して通信します。
   • .envファイルにBRAVE_SEARCH_API_KEYを追加する必要があります。
   • Brave Search APIからAPIキーを取得してください。

4. 天気API

   • WebFluxおよびStdio伝送での天気情報のクエリに使用されます。
   • .envファイルにWEATHER_API_KEYを追加する必要があります。
   • WeatherAPIからAPIキーを取得してください。