mcpField
S
spring-ai-mcp-client

spring-ai-mcp-client

本地服务
github.com/ogulcanarbcAI 与智能体4487 周前更新

关于 spring-ai-mcp-client

spring-ai-mcp-client 是一个基于 Spring AI 构建的 MCP 客户端应用,可连接支持 MCP 协议的服务并进行 AI 对话。它面向 Java 开发者,支持 Anthropic Claude 与 OpenAI 模型。

主要功能

  1. 01协议版本与能力协商
  2. 02工具发现与执行
  3. 03资源访问与提示词交互
  4. 04支持 roots 管理与 sampling
  5. 05支持 Anthropic 与 OpenAI 模型

适用场景

  1. 01在 Spring Boot 应用中接入 MCP 服务
  2. 02通过聊天接口调用 MCP 工具
  3. 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 密钥

安装

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"

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。