Spring Ai MCP Client

🚀 Spring AI MCP 客戶端

Spring AI MCP 客戶端應用程序藉助 Spring AI 與 Anthropic 的 Claude 模型（或 OpenAI 的模型），與支持 MCP 協議的服務器集成，實現基於人工智能的聊天交互，為用戶帶來智能便捷的聊天體驗。

🚀 快速開始

Spring MCP 客戶端是 MCP 架構中的關鍵組件，負責建立和管理與 MCP 服務器的連接，實現協議的客戶端部分，具備多種重要功能。

✨ 主要特性

• 協議版本協商：確保與服務器兼容。
• 功能協商：確定可用的功能。
• 消息傳輸和 JSON - RPC 通信：保障數據的高效傳輸。
• 工具發現和執行：方便用戶使用各類工具。
• 資源訪問和管理：合理調配資源。
• 提示系統交互：提供良好的交互體驗。
• 可選功能：如根目錄管理、採樣支持。
• 支持多模型：支持 OpenAI 和 Anthropic 模型。

📦 安裝指南

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 服務器名稱
        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 命令啟動聊天：

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

🔧 技術細節

需求

• Java 17+

• Maven 或 Gradle

• Docker（可選）

• Anthropic API 密鑰或 OpenAI API 密鑰

• Anthropic API 密鑰：從 Anthropic 控臺 獲取。

• OpenAI API 密鑰：從 OpenAI 控制檯 獲取。