spring-ai-mcp-client

模型上下文协议（MCP）客户端应用程序利用Spring AI和Anthropic Claude模型（或OpenAI）。它与支持MCP协议的服务器集成，以实现由AI驱动的聊天交互。

什么是Spring MCP客户端

MCP客户端是模型上下文协议（MCP）架构中的关键组件，负责建立和管理与MCP服务器的连接。 它实现了协议的客户端部分，处理以下内容：

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

需求

Java 17+
Maven 或 Gradle
Docker（可选）
Anthropic API密钥 或 OpenAI API密钥

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

安装

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命令开始聊天：

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