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.

Related MCP server: Redmine MCP Server

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.