Spring Ai MCP Client

🚀 Spring AI MCP Client

The Spring AI MCP Client application leverages Spring AI and Anthropic's Claude model (or OpenAI's models). It integrates with servers supporting the MCP protocol to enable AI-based chat interactions.

🚀 Quick Start

What is the Spring MCP Client?

The Spring MCP Client is a key component in the MCP architecture, responsible for establishing and managing connections with MCP servers. It implements the client part of the protocol and handles the following functions:

• Protocol version negotiation: Ensures compatibility with the server.
• Feature negotiation: Determines available features.
• Message transmission and JSON - RPC communication.
• Tool discovery and execution.
• Resource access and management.
• Prompt system interaction.
• Optional features: Such as root directory management and sampling support.
• Supports OpenAI and Anthropic models.

Requirements

• Java 17+

• Maven or Gradle

• Docker (optional)

• Anthropic API key or OpenAI API key

• Anthropic API key: Obtain it from the Anthropic Console.

• OpenAI API key: Obtain it from the OpenAI Console.

📦 Installation

1. Clone the repository

git clone <repo-url>
cd spring-ai-mcp-client

2. MCP Server Configuration

You must add MCP server information to the mcp - servers.json file as follows:

{
    "mcpServers":{
        "any-mcp-server":{
          "command":"node",
          "args":[
            "any-mcp-server/build/index.js"
          ]
        }
    }
}

3. Spring Configuration

The application.yml file should be configured as follows:

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 configuration, such as Claude desktop configuration.
    anthropic:
      api-key: ${ANTHROPIC_API_KEY}
#   openai:
#     api-key:  ${OPENAI_API_KEY}
server:
  port: 8081

4. Run the application

mvn clean install
mvn spring-boot:run

💻 Usage Examples

Basic Usage

Once the application is running, you can access it through the following endpoint:

• http://localhost:8091/ai

You can start a chat using the following cURL command:

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