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: Code Knowledge MCP Server

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: 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

Abrir la configuración de Cline: en VS Code, abra la extensión Cline y vaya a la pestaña Servidor MCP.
Editar la configuración de MCP: haga clic en "Editar la configuración de MCP" para abrir el archivo cline_mcp_settings.json .
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.
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.