Cómo Usar el Servidor MCP de Spring Boot

¿Listo para hacer que sus aplicaciones impulsadas por IA sean aún más inteligentes? Hoy, nos sumergimos en el Servidor MCP de SpringBoot, una herramienta fantástica que permite que modelos de IA como Claude o Cursor interactúen con sus datos a través del Protocolo de Contexto del Modelo (MCP). Imagine su IA extrayendo información de cursos o buscando datos específicos con solo unos pocos comandos, todo impulsado por una aplicación Spring Boot ligera. En esta guía conversacional, lo guiaremos a través de la configuración y el uso del Servidor MCP de SpringBoot, con una prueba para verlo en acción. ¡Vamos a codificar!

💡

¿Quiere una excelente herramienta de prueba de API que genere hermosa documentación de API?

¿Quiere una plataforma integrada y todo en uno para que su equipo de desarrolladores trabaje en conjunto con máxima productividad?

¡Apidog satisface todas sus demandas y reemplaza a Postman a un precio mucho más asequible!

button

¿Qué es el Servidor MCP de SpringBoot?

El Servidor MCP de SpringBoot es una aplicación Spring Boot que utiliza el framework Spring AI MCP para exponer sus datos como herramientas para modelos de IA. Es como darle a su IA una línea directa a los datos de su aplicación, como detalles de cursos, a través de herramientas MCP estandarizadas. En este tutorial, nos centraremos en un servidor que ofrece dos herramientas principales:

Obtener todos los juegos: Recupera una lista de todos los juegos disponibles.
Buscar juegos por título: Encuentra un juego específico por su título.

Esta configuración es perfecta para integrar datos externos con modelos de IA o construir sus propios servidores MCP. Además, está construido con Spring Boot, por lo que es fácil de usar para desarrolladores y fácil de extender. ¿Emocionado? ¡Vamos a configurarlo!

Cómo usar el Servidor MCP de SpringBoot

Requisitos previos

Antes de empezar, asegúrese de tener:

Java 24: Descargar desde oracle.com.
Maven 3.8+: Instalar desde maven.apache.org.
IntelliJ IDEA: Obtenerlo de jetbrains.com (o usar su IDE preferido).
Claude Desktop o Cursor: para probar con un cliente de IA (anthropic.com y curosor.com).
Conocimientos básicos de Spring Boot: Familiarizarse con los conceptos básicos de Spring Boot ayuda.

Paso 1: Crear un nuevo proyecto Spring Boot

Visite Spring Initializr:

Vaya a start.spring.io.
Configure su proyecto:
Proyecto: Maven
Lenguaje: Java
Spring Boot: 3.5.4 (última versión estable a julio de 2025)
Empaquetado: Jar
Versión de Java: 24 (o su versión instalada)
Agregue la dependencia del Servidor MCP de Spring AI:

Haga clic en Generar y descargue el proyecto.

Abrir en IntelliJ IDEA:

Descomprima el proyecto descargado y ábralo en IntelliJ IDEA como un nuevo proyecto.

Paso 2: Comprender la estructura del proyecto

Su Servidor MCP de SpringBoot incluye componentes clave:

Game.java: Un registro para datos de cursos (por ejemplo, título y URL).
GameService.java: Contiene herramientas MCP con anotaciones @Tool.
TestMcpServerApplication.java: La clase principal de la aplicación que registra herramientas.
application.properties: Configura el servidor MCP para transporte STDIO.

Aquí hay una configuración de ejemplo de application.properties:

spring.application.name=test-mcp-server
spring.main.web-application-type=none
spring.ai.mcp.server.name=game-demo-mcp
spring.ai.mcp.server.version=0.0.1
spring.main.banner-mode=off
logging.pattern.console=

Esto configura la aplicación como un servidor no web que utiliza transporte STDIO, perfecto para la comunicación MCP.

Paso 3: Definir el modelo de datos

Cree un registro simple Game.java para representar los datos del curso:

package com.example.testmcpserver;

public record Game(String title, String url){
}

Este registro inmutable contiene detalles del curso como el título y la URL, lo que facilita el procesamiento para los modelos de IA.

Paso 4: Implementar herramientas MCP

En GameService.java, defina herramientas usando la anotación @Tool. Aquí hay un ejemplo:

package com.example.testmcpserver;

import jakarta.annotation.PostConstruct;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.stereotype.Service;

import java.util.ArrayList;
import java.util.List;

@Service
public class GameService {

    private static final Logger log = LoggerFactory.getLogger(GameService.class);
    private List<Game> games = new ArrayList<>();

    @Tool(name = "get_games", description = "Get a list of games from the collection")
    public List<Game> getGames() {
        return games;
    }

    @Tool(name = "get_game", description = "Get a single game from from the collection by title")
    public Game getGame(String title) {
        return games.stream().filter(course -> course.title().equals(title)).findFirst().orElse(null);
    }

    @PostConstruct
    public void init() {
        games.addAll(List.of(
                new Game("GTA 6", "https://www.rockstargames.com/VI"),
                new Game("FC 26","https://www.ea.com/en/games/ea-sports-fc/fc-26"),
                new Game("Call of Duty: Black Ops 7","https://www.callofduty.com/blackops7")
        ));
    }

}

Estas herramientas permiten a los modelos de IA recuperar todos los cursos o encontrar un curso específico por título.

Paso 5: Registrar herramientas con el framework MCP

En TestMcpServerApplication.java, registre las herramientas:

package com.example.testmcpserver;

import org.springframework.ai.support.ToolCallbacks;
import org.springframework.ai.tool.ToolCallback;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

import java.util.List;

@SpringBootApplication
public class TestMcpServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(TestMcpServerApplication.class, args);
    }

    @Bean
    public List<ToolCallback> danTools(GameService gameService) {
        return List.of(ToolCallbacks.from(gameService));
    }

}

El método ToolCallbacks.from() escanea GameService en busca de anotaciones @Tool y las registra con el Servidor MCP de SpringBoot.

Paso 6: Ejecutar el Servidor MCP de SpringBoot

Construir y ejecutar:

En IntelliJ, abra una terminal y ejecute:

mvn spring-boot:run

El servidor se inicia como un servidor MCP utilizando transporte STDIO, sin interfaz web.

Verificar herramientas:

El servidor registra dos herramientas: get_games (listar todos los juegos) y get_game (encontrar un juego por título).

Paso 7: Conectarse a Cursor o Claude Desktop

Para usar el Servidor MCP de SpringBoot con Claude Desktop:

Compilar el proyecto:

Construir el archivo JAR:

mvn clean package

Encuentre el JAR en target/test-mcp-server-0.0.1-SNAPSHOT.jar.

A. Configurar Claude Desktop:

Abra claude_desktop_config.json (macOS: ~/Library/Application Support/Claude, Windows: %APPDATA%\Claude).
Agregue:

{
  "mcpServers": {
    "game-demo-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "path/to/test-mcp-server-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

Reemplace path/to/ con la ruta real a su archivo JAR (por ejemplo, D:/Apidog_Projects/spring-boot-mcp-server/test-mcp-server/target/test-mcp-server-0.0.1-SNAPSHOT.jar).

Reiniciar Claude Desktop:

Cierre y vuelva a abrir Claude para aplicar la configuración.

B. Configurar Cursor:

Navegue a Configuración, luego Configuración de Cursor
Seleccione Herramientas e integraciones
Haga clic en Nuevo servidor MCP

Paso 8: Probar el Servidor MCP de SpringBoot

Probemos el servidor con Claude Desktop:

Abra Claude Desktop o Cursor y emita un comando:

En su cliente mcp, ingrese:

Using the MCP server, get all available games. (Usando el servidor MCP, obtén todos los juegos disponibles.)

Claude (o Cursor) debería responder con:

Available games:
- Title: GTA 6, URL: https://www.rockstargames.com/VI
- Title: FC 26, URL: https://www.ea.com/en/games/ea-sports-fc/fc-26

Pruebe un juego específico:

Ingrese:

Using the MCP server, get the game with title "FC 26". (Usando el servidor MCP, obtén el juego con el título "FC 26".)

Respuesta esperada:

Game: FC 26, URL: https://www.ea.com/en/games/ea-sports-fc/fc-26

¡Esto confirma que su Servidor MCP de SpringBoot está funcionando!

Paso 9: Extender el Servidor MCP de SpringBoot

¿Quiere hacerlo aún más genial? Aquí tiene algunas ideas:

Agregar más cursos: Actualice el método init() de GameService para incluir más objetos Game.
Nuevas herramientas: Agregue métodos con anotaciones @Tool, como una función de búsqueda:

@Tool(name = "search_games", description = "Search games containing a keyword")
public List<Game> searchGames(String keyword) {
    return games.stream()
        .filter(game -> game.title().toLowerCase().contains(keyword.toLowerCase()))
        .collect(Collectors.toList());
}

Usar una base de datos: Reemplace la lista games en memoria con una conexión a una base de datos.
Mejorar la búsqueda: Agregue coincidencia difusa o filtros de categoría.

Consejos para la resolución de problemas

¿El servidor no arranca? Asegúrese de que Java 24 y Maven estén instalados, y verifique application.properties para la configuración correcta.
¿Claude no se conecta? Verifique la ruta del JAR en claude_desktop_config.json y reinicie Claude.
¿Herramientas no encontradas? Confirme que las anotaciones @Tool sean correctas y que ToolCallbacks esté registrado.
¿No hay salida? Verifique la terminal que ejecuta mvn spring-boot:run en busca de errores.

¿Por qué usar el Servidor MCP de SpringBoot?

El Servidor MCP de SpringBoot es un sueño para los desarrolladores que aman la simplicidad de Spring Boot y quieren integrar la IA con sus datos. Es ligero, utiliza STDIO para una comunicación segura y permite que modelos de IA como Claude accedan a los datos de su aplicación en tiempo real. Ya sea que esté construyendo una plataforma de cursos u otra aplicación basada en datos, este servidor facilita la integración de la IA.

Nuestra prueba con Claude Desktop y Cursor demostró lo fácil que es obtener datos de juegos. Imagine escalar esto para manejar consultas complejas o conectarse a una base de datos real, ¡posibilidades infinitas!

Conclusión

¡Y eso es todo! Ha aprendido a configurar y usar el Servidor MCP de SpringBoot para llevar el acceso a datos impulsado por IA a sus aplicaciones. Desde la creación de un proyecto Spring Boot hasta la conexión con Claude Desktop y la prueba de consultas de cursos, ahora está listo para construir integraciones de IA más inteligentes. Intente agregar nuevas herramientas o conectar una base de datos para ir más allá.

💡

button