convez.ai
MCP ServerIntegração & APIsIntermediário
ogulcanarbc

Spring AI MCP Client

ogulcanarbc/spring-ai-mcp-client

Cliente MCP em Spring para integrar IA com servidores compatíveis

Ver no GitHub
InicialPluginScore · de 0 a 100

Cliente MCP em Java que integra Spring AI com servidores compatíveis com Model Context Protocol, permitindo interações de chat alimentadas por IA. Suporta modelos Anthropic Claude e OpenAI, com negociação de protocolo, descoberta de ferramentas e gerenciamento de recursos.

Instalação

$npx convez-ai ogulcanarbc/spring-ai-mcp-client

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
44
Forks
2
Acompanhando
1
Saúde
28%
Último commit
há 1 ano
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Construir aplicações Java que se conectem a servidores MCP
  • Integrar Claude ou OpenAI em sistemas Spring Boot
  • Executar ferramentas remotas e acessar recursos via MCP

Veredito

Solução sólida para quem precisa conectar aplicações Spring ao ecossistema MCP. Bem documentada e com suporte a múltiplos provedores de IA, mas exige conhecimento prévio de Spring e configuração de servidores MCP.

README

A tradução para o português deste README ainda está na fila.

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

Installation

1. Clone Repository

    git clone <repo-url>
    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:

You can start a chat with the following cURL command:

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

Ver o original no GitHub

Bom para

Relacionados