MCP Server Redmine — Integración de Redmine con Agentes de IA
Descripción General
MCP Server Redmine es un servidor open source del Model Context Protocol que conecta Redmine, el clásico gestor de proyectos, con asistentes de IA como Claude. Expone 32 herramientas sobre la API REST de Redmine mediante transporte stdio, cubriendo issues, relaciones entre issues, proyectos, usuarios, registro de horas, páginas wiki, noticias, archivos, búsqueda y roles. Con él, gestionar un proyecto se convierte en una conversación: crear un issue, registrar horas o consultar una wiki sin salir del asistente.El proyecto está publicado en GitHub y distribuido como paquete de npm, ejecutable directamente con npx mcp-server-redmine.
Características Principales:
32 herramientas sobre la API REST de Redmine: Cobertura de 11 áreas de recursos — issues (listar con filtros, crear, actualizar, eliminar), relaciones entre issues, proyectos, usuarios, cuenta propia, registro de horas, wikis, noticias, archivos, búsqueda global y roles.
Integración con Claude Desktop y Claude Code: Configuración documentada para ambos clientes; basta añadir un bloque JSON con el comando npx y las credenciales para tener Redmine disponible como herramientas del asistente.
Configuración mínima: Solo dos variables de entorno (REDMINE_URL y REDMINE_API_KEY) — sin base de datos propia ni servicios adicionales.
Validación estricta con Zod: Cada herramienta define su schema de entrada tipado, de modo que el LLM recibe descripciones precisas de los parámetros y los errores se detectan antes de llegar a la API.
Niveles de estabilidad por herramienta: Cada tool está etiquetada como Stable, Alpha o Prototype siguiendo los niveles de estabilidad de la propia API de Redmine, para que el usuario sepa qué esperar en producción.
El principal desafío fue traducir una API REST tan extensa y veterana como la de Redmine a herramientas que un LLM pueda usar con fiabilidad: cada endpoint se modeló como una tool con schema Zod descriptivo, nombres consistentes y filtros expresados como parámetros tipados, evitando que el modelo tenga que adivinar formatos. Además, se adoptó el sistema de niveles de estabilidad de Redmine (Stable/Alpha/Prototype) por herramienta, lo que permitió publicar cobertura amplia del API sin ocultar qué partes aún necesitan feedback de integradores.
Resultados e Impacto
Publicado en npm: Instalable y ejecutable con un solo comando (npx mcp-server-redmine), sin clonar el repo ni compilar nada.
Gestión de proyectos conversacional: Crear issues, registrar horas o buscar en wikis desde Claude, sin abrir la interfaz web de Redmine.
Cobertura amplia del API: 32 herramientas sobre 11 áreas de recursos de Redmine disponibles para cualquier cliente MCP.
Proyecto abierto y mantenible: Licencia MIT, guía de contribución, plantillas de issues y política de seguridad para reportes privados de vulnerabilidades.
