Redmine MCP Server for Cline

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.