Spring Ai MCP Client

🚀 Spring AI MCP クライアント

Spring AI MCP クライアントアプリケーションは、Spring AI と Anthropic の Claude モデル（または OpenAI のモデル）を利用します。MCP プロトコルをサポートするサーバーと統合し、人工知能に基づくチャットインタラクションを実現します。

🚀 クイックスタート

Spring AI MCP クライアントを使用することで、MCP プロトコルをサポートするサーバーとの接続を通じて、AI ベースのチャットインタラクションを行うことができます。以下に、クライアントのセットアップと使用方法を説明します。

✨ 主な機能

Spring MCP クライアントは MCP アーキテクチャの重要なコンポーネントで、MCP サーバーとの接続を確立および管理します。プロトコルのクライアント部分を実装し、以下の機能を処理します。

• プロトコルバージョンの交渉：サーバーとの互換性を確保します。
• 機能の交渉：利用可能な機能を決定します。
• メッセージの送信と JSON - RPC 通信
• ツールの発見と実行
• リソースのアクセスと管理
• プロンプトシステムとのインタラクション
• オプション機能：ルートディレクトリ管理、サンプリングサポートなど
• OpenAI と Anthropic モデルのサポート

📦 インストール

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

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

2. MCP サーバーの設定

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

{
    "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 サーバー名
        version: 1.0.0
        type: SYNC
        request-timeout: 20s
        stdio:
          root-change-notification: true
          servers-configuration: classpath:mcp-servers.json # MCP サーバーの設定、Claude デスクトップ設定など
    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 コマンドでチャットを開始できます。

📚 ドキュメント

必要条件

• Java 17 以上

• Maven または Gradle

• Docker（オプション）

• Anthropic API キーまたは OpenAI API キー

• Anthropic API キー：Anthropic コンソール から取得します。

• OpenAI API キー：OpenAI コンソール から取得します。