spring-ai-mcp-client

Name: spring-ai-mcp-client
Author: ogulcanarbc

@ogulcanarbc

关于 spring-ai-mcp-client

mcp client application that utilizes spring ai. it integrates with mcp protocol-supported servers to enable ai-powered chat interactions.

#mcp #anthropic-claude #spring-ai #mcp-client

基本信息

分类

其他

运行时

java

传输方式

stdio

发布者

ogulcanarbc

配置

暂无标准配置

该服务器的 README 中没有可解析的 MCP 配置块，请前往代码仓库查看安装说明。

代码仓库

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is spring-ai-mcp-client?

spring-ai-mcp-client is a Java-based Model Context Protocol (MCP) client built with Spring AI. It connects to MCP protocol–supported servers and enables AI-powered chat interactions using Anthropic Claude or OpenAI models. It handles protocol version negotiation, capability negotiation, tool discovery and execution, resource access, prompt system interactions, and optional features like roots management and sampling.

How to use spring-ai-mcp-client?

Clone the repository, configure MCP server details in an mcp-servers.json file, set your Anthropic or OpenAI API key, and provide Spring Boot configuration in application.yml. Then run mvn spring-boot:run and access the chat endpoint at http://localhost:8081/ai with a GET request containing a message parameter.

Key features of spring-ai-mcp-client

Client-side MCP protocol implementation including version negotiation
Supports Anthropic Claude and OpenAI models
Manages communication via JSON‑RPC over stdio transport
Enables tool discovery, execution, resource access, and prompt interactions
Optional support for roots management and sampling
Configurable request timeout, server name, and sync type

Use cases of spring-ai-mcp-client

Building AI‑powered chatbots that leverage external MCP‑compatible servers
Integrating model context tools and resources into Spring‑based applications
Creating a unified gateway to query multiple MCP servers with a single API call
Prototyping conversational AI features with either Anthropic or OpenAI models

FAQ from spring-ai-mcp-client

What AI models does spring-ai-mcp-client support?

It supports both Anthropic Claude models and OpenAI models. You configure the API key in application.yml for either provider.

What are the runtime requirements?

Java 17 or later, Maven or Gradle for building, and optionally Docker. You also need either an Anthropic API key or an OpenAI API key.

How do I configure MCP servers?

Create an mcp-servers.json file (placed on the classpath) listing each server’s command and arguments. Then reference that file in spring.ai.mcp.client.stdio.servers-configuration in your application.yml.

What transport and protocol does spring-ai-mcp-client use?

It uses stdio transport with JSON‑RPC message format. The client negotiates protocol version and capabilities with the server automatically.

Where is the chat endpoint and how do I invoke it?

The application runs on port 8081 by default (configurable via server.port). Send a GET request to http://localhost:8081/ai?message=YourQuestion to start a chat.