Dependencias de Maven del servidor MCP
Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona herramientas para verificar las versiones de las dependencias de Maven. Este servidor permite a los LLM verificar las dependencias de Maven y recuperar sus últimas versiones del Repositorio Central de Maven.
Instalación
Puede instalar este servidor MCP globalmente usando npm:
npm install -g mcp-maven-deps
O ejecútelo directamente usando npx:
Para instalar Maven Dependencies Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install maven-deps-server --client claude
Características
- Consultar la última versión de cualquier dependencia de Maven
- Verificar si existe una dependencia de Maven
- Comprobar si existe una versión específica de una dependencia
- Soporte para coordenadas Maven completas, incluido empaquetado y clasificador
- Acceso en tiempo real a los datos del repositorio central de Maven
- Compatible con múltiples formatos de herramientas de compilación (Maven, Gradle, SBT, Mill)
Para desarrollo:
- Clonar este repositorio
- Instalar dependencias:
npm install - Construya el servidor:
npm run build
Configuración
Agregue el servidor a su archivo de configuración de MCP:
{
"mcpServers": {
"maven-deps-server": {
"command": "npx",
"args": ["mcp-maven-deps"]
}
}
}
Si se instala globalmente, también puedes usar:
{
"mcpServers": {
"maven-deps-server": {
"command": "mcp-maven-deps"
}
}
}
Opciones de transporte
El servidor admite dos modos de transporte:
- stdio (predeterminado): comunicación de entrada/salida estándar
- SSE (Eventos enviados por el servidor): comunicación basada en HTTP con acceso remoto opcional
Para utilizar el transporte SSE, puede especificar tanto el host como el puerto:
# Local access only (default host: localhost)
npx mcp-maven-deps --port=3000
# Remote access
npx mcp-maven-deps --host=0.0.0.0 --port=3000
Al utilizar el transporte SSE en la configuración de MCP:
{
"mcpServers": {
"maven-deps-server": {
"command": "npx",
"args": ["mcp-maven-deps", "--port=3000"]
}
}
}
Para acceso remoto, utilice la IP o el nombre de host del servidor en la configuración de su cliente:
{
"mcpServers": {
"maven-deps-server": {
"command": "npx",
"args": ["mcp-maven-deps", "--host=your-server-ip", "--port=3000"]
}
}
}
Herramientas disponibles
obtener_la_última_versión_de_maven
Recupera la última versión de una dependencia de Maven.
Esquema de entrada:
{
"type": "object",
"properties": {
"dependency": {
"type": "string",
"description": "Maven coordinate in format \"groupId:artifactId[:version][:packaging][:classifier]\" (e.g. \"org.springframework:spring-core\" or \"org.springframework:spring-core:5.3.20:jar\")"
}
},
"required": ["dependency"]
}
Ejemplo de uso:
const result = await mcpClient.callTool("maven-deps-server", "get_maven_latest_version", {
dependency: "org.springframework:spring-core"
});
// Returns: "6.2.2"
comprobar_que_la_versión_de_maven_existe
Comprueba si existe una versión específica de una dependencia de Maven. La versión puede proporcionarse en la cadena de dependencia o como un parámetro independiente.
Esquema de entrada:
{
"type": "object",
"properties": {
"dependency": {
"type": "string",
"description": "Maven coordinate in format \"groupId:artifactId[:version][:packaging][:classifier]\" (e.g. \"org.springframework:spring-core\" or \"org.springframework:spring-core:5.3.20:jar\")"
},
"version": {
"type": "string",
"description": "Version to check if not included in dependency string"
}
},
"required": ["dependency"]
}
Ejemplo de uso:
// Using version in dependency string
const result1 = await mcpClient.callTool("maven-deps-server", "check_maven_version_exists", {
dependency: "org.springframework:spring-core:5.3.20"
});
// Using separate version parameter
const result2 = await mcpClient.callTool("maven-deps-server", "check_maven_version_exists", {
dependency: "org.springframework:spring-core",
version: "5.3.20"
});
Detalles de implementación
- Utiliza la API REST de Maven Central para obtener información de dependencia
- Admite coordenadas Maven completas (groupId:artifactId:version:packaging:classifier)
- Ordena los resultados por marca de tiempo para garantizar que se devuelva la última versión
- Incluye manejo de errores para dependencias no válidas y problemas de API.
- Devuelve cadenas de versiones limpias y analizables para dependencias válidas
- Proporciona respuestas booleanas para las comprobaciones de existencia de versiones
Manejo de errores
El servidor maneja varios casos de error:
- Formato de dependencia no válido
- Formato de versión no válido
- Dependencias inexistentes
- Problemas de conexión de API
- Respuestas malformadas
- Falta información de la versión
Desarrollo
Para modificar o ampliar el servidor:
- Realizar cambios en
src/index.ts - Reconstruir usando
npm run build - Reinicie el servidor MCP para aplicar los cambios
Licencia
Instituto Tecnológico de Massachusetts (MIT)