Servidor MCP de Redmine para Cline

Este es un servidor MCP (Protocolo de contexto de modelo) personalizado que se integra con Redmine, lo que le permite interactuar con sus proyectos y problemas de Redmine a través de la extensión Cline VS Code.

Prerrequisitos

• Node.js: necesita tener Node.js (versión 18 o más reciente) instalado en su sistema.
• Instancia de Redmine: necesita una instancia de Redmine en ejecución con la API REST habilitada.
• Clave API de Redmine: Necesita una clave API para su cuenta de usuario de Redmine. Puede encontrarla en la configuración de su cuenta de Redmine (normalmente en "Mi cuenta" -> "Clave de acceso API").
• Cline: necesita la extensión Cline VS Code instalada y configurada.

Instalación

1. Clonar el repositorio:
   git clone https://github.com/ilask/Redmine-MCP.git cd Redmine-MCP
2. Instalar dependencias:
   npm install

Configuración

1. Establecer variables de entorno: cree un archivo .env en la raíz del directorio del proyecto y agregue lo siguiente, reemplazando los marcadores de posición con su nombre de host de Redmine y su clave API reales:
   REDMINE_HOST=your-redmine-host.com REDMINE_API_KEY=your-redmine-api-key
   Importante: ¡No envíe su archivo .env al control de versiones! Contiene información confidencial. El archivo .gitignore incluido en este repositorio debería impedir que se envíe.

Añadiendo a Cline

1. Abrir la configuración de Cline: en VS Code, abra la extensión Cline y vaya a la pestaña Servidor MCP.
2. Editar la configuración de MCP: haga clic en "Editar la configuración de MCP" para abrir el archivo cline_mcp_settings.json .
3. Agregar el servidor: agregue la siguiente entrada al objeto mcpServers , reemplazando la ruta args con la ruta absoluta al archivo server.js en su sistema:
   { "mcpServers": { "redmine-server": { "command": "node", "args": ["C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"], "disabled": false, "autoApprove": [] } } }
   Importante: asegúrese de utilizar barras invertidas dobles ( \\ ) en la ruta en Windows.
4. Guardar: Guarde el archivo cline_mcp_settings.json . Cline debería detectar los cambios automáticamente e iniciar el servidor.

Recursos y herramientas disponibles

Recursos

• redmine://projects/{project_id} : Este recurso representa un proyecto de Redmine. Reemplace {project_id} con el ID real de un proyecto en su instancia de Redmine. Puede usar la herramienta access_mcp_resource en Cline para leer los detalles de un proyecto. Por ejemplo:
  <access_mcp_resource> <server_name>redmine-server</server_name> <uri>redmine://projects/123</uri> </access_mcp_resource>

(Reemplace 123 con un ID de proyecto válido). Esto devolverá los detalles del proyecto en formato JSON.

Herramientas

• create_issue : Esta herramienta permite crear un nuevo problema en Redmine. Acepta los siguientes parámetros:
  • project_id (cadena, obligatoria): el ID del proyecto donde debe crearse el problema.
  • subject (cadena, obligatorio): el asunto del problema.
  • description (cadena, obligatoria): la descripción del problema.

  Puedes usar la herramienta use_mcp_tool en Cline para llamar a esta herramienta. Por ejemplo:

  <use_mcp_tool> <server_name>redmine-server</server_name> <tool_name>create_issue</tool_name> <arguments> { "project_id": "456", "subject": "My New Issue", "description": "This is a test issue created via Cline." } </arguments> </use_mcp_tool>

  (Reemplace 456 con un ID de proyecto válido). Esto creará un nuevo problema en el proyecto especificado y devolverá los detalles del problema en formato JSON.

Solución de problemas

• Error de conexión cerrada: Si ve un error como "Error MCP -1: Conexión cerrada", asegúrese de que las variables de entorno REDMINE_HOST y REDMINE_API_KEY estén configuradas correctamente. Además, asegúrese de que su instancia de Redmine sea accesible desde su equipo.
• Revisar los registros del servidor: Si encuentra problemas, revise la salida del servidor en la terminal de VS Code para ver si hay mensajes de error. El servidor registra los errores en la consola.