Redmine MCP Server

Un servidor MCP (Model Context Protocol) que conecta asistentes de IA como Kiro a tu instancia de Redmine. Expone 15 herramientas que cubren Incidencias, Proyectos y Búsqueda, lo que permite a tu asistente de IA crear incidencias, actualizar proyectos, buscar en recursos y más, todo mediante conversación natural.

Qué hace

Una vez configurado, puedes pedirle a tu asistente de IA cosas como:

• "Lista todas las incidencias abiertas asignadas a mí"

• "Crea un informe de error para el fallo de la página de inicio de sesión"

• "Busca incidencias relacionadas con la migración de la base de datos"

• "Archiva el proyecto old-website"

• "Añade a John como observador en la incidencia #42"

El servidor maneja la autenticación, la paginación, la validación de entrada y el manejo de errores automáticamente.

Related MCP server: @a-bonus/redmine-mcp

Herramientas disponibles

Requisitos previos

1. Python 3.10+ instalado en tu máquina

2. uv — un gestor de paquetes de Python rápido (guía de instalación)

   • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

   • Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. Clave de API de Redmine — obtén la tuya desde tu instancia de Redmine:

   • Inicia sesión en Redmine

   • Ve a Mi cuenta (menú superior derecho)

   • En la barra lateral derecha, encuentra Clave de acceso a la API y haz clic en Mostrar

   • Copia la clave

Configuración con Kiro

Paso 1: Añade la configuración del servidor MCP a Kiro

Crea o edita ~/.kiro/settings/mcp.json (esto lo hace disponible en todos tus proyectos):

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/bizcloud-experts/redmine-mcp-server.git", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Reemplaza:

• https://your-redmine-instance.com con tu URL de Redmine

• your-api-key-here con tu clave de API de Redmine

También puedes colocar esto en .kiro/settings/mcp.json dentro de un espacio de trabajo específico si solo quieres que esté disponible allí.

Paso 2: Abre Kiro

El servidor MCP se iniciará automáticamente cuando Kiro se lance. Puedes verificar que funciona preguntando: "Lista mis proyectos de Redmine."

Alternativa: Si git no está instalado

Si recibes un error "Git executable not found", puedes usar una instalación basada en zip que no requiere git en tu máquina:

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "redmine-mcp-server @ https://github.com/bizcloud-experts/redmine-mcp-server/archive/refs/heads/main.zip", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Configuración alternativa: Instalación local

Si prefieres ejecutar desde un clon local en lugar de uvx:

git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install .

Entonces usa esta configuración MCP en su lugar:

{
  "mcpServers": {
    "redmine": {
      "command": "/absolute/path/to/redmine-mcp/.venv/bin/redmine-mcp-server",
      "args": [],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Solución de problemas

Desarrollo

git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest