Spring AI MCP 客户端

Spring AI MCP 客户端应用程序利用 Spring AI 和 Anthropic 的 Claude 模型（或 OpenAI 的模型）。它与支持 MCP 协议的服务器集成，以实现基于人工智能的聊天交互。

什么是 Spring MCP 客户端

Spring MCP 客户端是 MCP 架构中的一个关键组件，负责建立和管理与 MCP 服务器的连接。它实现了协议的客户端部分，处理以下功能：

• 协议版本协商：确保与服务器兼容
• 功能协商：确定可用的功能
• 消息传输和 JSON-RPC 通信
• 工具发现和执行
• 资源访问和管理
• 提示系统交互
• 可选功能：如根目录管理、采样支持
• 支持 OpenAI 和 Anthropic 模型

需求

• Java 17+

• Maven 或 Gradle

• Docker（可选）

• Anthropic API 密钥或 OpenAI API 密钥

• Anthropic API 密钥：从 Anthropic 控台 获取。

• OpenAI API 密钥：从 OpenAI 控制台 获取。

安装

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 命令启动聊天：