Клиентское приложение Model Context Protocol (MCP) использует модели Spring AI и Anthropic Claude (Or OpenAI). Он интегрируется с серверами, поддерживаемыми протоколом MCP, для обеспечения взаимодействия чата на основе ИИ.

Что такое Spring MCP Client Клиент MCP является ключевым компонентом архитектуры Model Context Protocol (MCP), отвечающим за установление и управление соединениями с серверами MCP. Он реализует клиентскую сторону протокола, обрабатывая:

Переговоры по протокольной версии для обеспечения совместимости с серверами Переговоры о способности определять доступные функции

• Транспортировка сообщений и связь JSON-RPC
• Обнаружение и выполнение инструментов
• Доступ к ресурсам и управление ими Быстрые системные взаимодействия
• Дополнительные функции, такие как управление корнями и поддержка выборки Поддержка openai и антропных моделей

Требования

Java 17+ Maven или Gradle Docker (необязательно) Антропный API ключ или OpenAI API ключ

Антропный API-ключ от Anthropic Console. Открытый API-ключ от OpenAI Console.

##Установка ###1 Репозиторий клонов

гит-клон cd Spring-ai-mcp-клиент

###2 Конфигурация сервера MCP

Информация о сервере MCP должна быть добавлена к серверам mcp.

spring-ai-mcp-client

The Model Context Protocol (MCP) client application utilizes Spring AI and Anthropic Claude models (Or OpenAI). It integrates with MCP protocol-supported servers to enable AI-powered chat interactions.

What is Spring MCP Client

The MCP Client is a key component in the Model Context Protocol (MCP) architecture, responsible for establishing and managing connections with MCP servers. It implements the client-side of the protocol, handling:

- Protocol version negotiation to ensure compatibility with servers
- Capability negotiation to determine available features
- Message transport and JSON-RPC communication
- Tool discovery and execution
- Resource access and management
- Prompt system interactions
- Optional features like roots 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 from the Anthropic Console.
• OpenAI API key from the OpenAI Console.

Installation

1. Clone Repository

    git clone 
    cd spring-ai-mcp-client

2. MCP Server Configuration

The MCP server information must be added 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 config such/same as claude desktop configs.
    anthropic:
      api-key: ${ANTHROPIC_API_KEY}
#   openai:
#     api-key:  ${OPENAI_API_KEY}  
server:
  port: 8081

4. Run Applicaton

mvn clean install
mvn spring-boot:run

Usage

Once the application is running, it can be accessed via the following endpoint:

• http://localhost:8091/ai

You can start a chat with the following cURL command:

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