关于 spring-ai-mcp-client
spring-ai-mcp-client 是一个基于 Spring AI 构建的 MCP 客户端应用,可连接支持 MCP 协议的服务并进行 AI 对话。它面向 Java 开发者,支持 Anthropic Claude 与 OpenAI 模型。
主要功能
- 01协议版本与能力协商
- 02工具发现与执行
- 03资源访问与提示词交互
- 04支持 roots 管理与 sampling
- 05支持 Anthropic 与 OpenAI 模型
适用场景
- 01在 Spring Boot 应用中接入 MCP 服务
- 02通过聊天接口调用 MCP 工具
- 03基于 Claude 或 OpenAI 构建 AI 对话功能
MCP 相关
该应用作为 MCP 客户端,根据 mcp-servers.json 和 application.yml 的配置建立并管理与 MCP 服务的连接。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
spring-ai-mcp-client
此 Model Context Protocol(MCP)客户端应用使用 Spring AI 和 Anthropic Claude 模型(或 OpenAI)。它与支持 MCP 协议的服务集成,以实现 AI 驱动的聊天交互。
什么是 Spring MCP 客户端
MCP 客户端是 Model Context Protocol(MCP)架构中的关键组件,负责建立和管理与 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
使用方法
应用运行后,可通过以下端点访问:
你可以使用以下 cURL 命令开始聊天:
curl -X GET "http://localhost:8081/ai?message=Hello" -H "Accept: application/json"
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。