Spring Ai MCP Client

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