Redmine MCP Server for Cline

Se integra con Redmine para gestionar proyectos y problemas a través de la extensión Cline de VS Code.

Documentación

Redmine MCP Server para Cline

Este es un servidor MCP (Protocolo de Contexto de Modelo) personalizado que se integra con Redmine, permitiéndote interactuar con tus proyectos y problemas de Redmine a través de la extensión Cline de VS Code.

Requisitos previos

Node.js: Necesitas tener Node.js (versión 18 o superior) instalado en tu sistema.
Instancia de Redmine: Necesitas una instancia de Redmine en funcionamiento con la API REST habilitada.
Clave API de Redmine: Necesitas una clave API para tu cuenta de usuario de Redmine. Puedes encontrarla en la configuración de tu cuenta de Redmine (generalmente en "Mi cuenta" -> "Clave de acceso API").
Cline: Necesitas tener la extensión Cline de VS Code instalada y configurada.

Instalación

Clonar el repositorio:

git clone https://github.com/ilask/Redmine-MCP.git
cd Redmine-MCP

Instalar dependencias:
```
npm install
```

Configuración

Establecer variables de entorno: Crea un archivo .env en la raíz del directorio del proyecto y agrega lo siguiente, reemplazando los marcadores de posición con tu nombre de host y clave API reales de Redmine:
```
REDMINE_HOST=your-redmine-host.com
REDMINE_API_KEY=your-redmine-api-key
```
Importante: ¡No confirmes tu archivo .env en el control de versiones! Contiene información sensible. El archivo .gitignore incluido en este repositorio debería evitar que se confirme.

Agregar a Cline

Abrir la configuración de Cline: En VS Code, abre la extensión Cline y ve a la pestaña Servidor MCP.
Editar la configuración de MCP: Haz clic en "Editar configuración de MCP" para abrir el archivo cline_mcp_settings.json.
Agregar el servidor: Agrega la siguiente entrada al objeto mcpServers, reemplazando la ruta args con la ruta absoluta al archivo server.js en tu sistema:
```
{
  "mcpServers": {
    "redmine-server": {
      "command": "node",
      "args": ["C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
```
Importante: Asegúrate de usar barras invertidas dobles (\\) en la ruta en Windows.
Guardar: Guarda el archivo cline_mcp_settings.json. Cline debería detectar automáticamente los cambios e iniciar el servidor.

Recursos y herramientas disponibles

Recursos

redmine://projects/{project_id}: Este recurso representa un proyecto de Redmine. Reemplaza {project_id} con el ID real de un proyecto en tu instancia de Redmine. Puedes 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>
```

(Reemplaza 123 con un ID de proyecto válido). Esto devolverá los detalles del proyecto como JSON.

Herramientas

create_issue: Esta herramienta te permite crear un nuevo problema en Redmine. Acepta los siguientes parámetros:
- project_id (cadena, obligatorio): El ID del proyecto donde se debe crear el problema.
- subject (cadena, obligatorio): El asunto del problema.
- description (cadena, obligatorio): 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>
```
(Reemplaza 456 con un ID de proyecto válido). Esto creará un nuevo problema en el proyecto especificado y devolverá los detalles del problema como JSON.

Solución de problemas

Error de conexión cerrada: Si ves un error como "MCP error -1: Connection closed", asegúrate de que tus variables de entorno REDMINE_HOST y REDMINE_API_KEY estén configuradas correctamente. Además, verifica que tu instancia de Redmine sea accesible desde tu computadora.
Revisar registros del servidor: Si encuentras problemas, revisa la salida del servidor en la terminal de VS Code para ver cualquier mensaje de error. El servidor registra errores en la consola.