spring-ai-mcp-client

spring-ai-mcp-client

この Model Context Protocol（MCP）クライアントアプリケーションは、Spring AI と Anthropic Claude モデル（または OpenAI）を利用します。MCP プロトコルに対応したサーバーと連携し、AI を活用したチャットを実現します。

Spring MCP Client とは

MCP クライアントは、MCP サーバーとの接続を確立して管理する、Model Context Protocol（MCP）アーキテクチャの重要なコンポーネントです。 プロトコルのクライアント側を実装し、次の処理を行います。

- サーバーとの互換性を確保するためのプロトコルバージョンのネゴシエーション
- 利用可能な機能を判断するための機能ネゴシエーション
- メッセージの転送と JSON-RPC 通信
- ツールの検出と実行
- リソースへのアクセスと管理
- プロンプトシステムとのやり取り
- ルート管理やサンプリング対応などのオプション機能
- OpenAI モデルと Anthropic モデルに対応

要件

Java 17+
Maven または Gradle
Docker（任意）
Anthropic API キーまたは OpenAI API キー

• Anthropic Console から Anthropic API キーを取得します。
• OpenAI Console から OpenAI API キーを取得します。

インストール

1. リポジトリのクローン

    git clone <repo-url>
    cd spring-ai-mcp-client

2. MCP サーバーの設定

以下のように、MCP サーバーの情報を mcp-servers.json ファイルに追加する必要があります。

{
    "mcpServers":{
        "any-mcp-server":{
          "command":"node",
          "args":[
            "any-mcp-server/build/index.js"
          ]
        }
    }
}

3. Spring の設定

以下のように application.yml ファイルを設定します。

spring:
  ai:
    mcp:
      client:
        enabled: true
        name: any-mcp-server # MCP server name
        version: 1.0.0
        type: SYNC
        request-timeout: 20s
        stdio:
          root-change-notification: true
          servers-configuration: classpath:mcp-servers.json # MCP server config such/same as claude desktop configs.
    anthropic:
      api-key: ${ANTHROPIC_API_KEY}
#   openai:
#     api-key:  ${OPENAI_API_KEY}  
server:
  port: 8081

4. アプリケーションの実行

mvn clean install
mvn spring-boot:run

使用方法

アプリケーションの起動後、次のエンドポイントからアクセスできます。

• http://localhost:8091/ai

次の cURL コマンドを使用してチャットを開始できます。

curl -X GET "http://localhost:8081/ai?message=Hello" -H "Accept: application/json"