Servidor MCP de Redmine

Esta es una implementación de servidor del Protocolo de Contexto de Modelo (MCP) para Redmine. Se integra con la API REST de Redmine para proporcionar información sobre tickets y proyectos a los LLM.

Características

Admite recursos estables de la API REST de Redmine:

• Problemas (1.0~)

• Proyectos (1.0~)

• Usuarios (1.1~)

• Entradas de tiempo (1.1~)

Herramientas

Asuntos

• Problemas de búsqueda

  • Filtrar por proyecto, estado, asignado, etc.

  • Búsqueda de palabras clave

  • Soporte de campos personalizados

• Crear/actualizar problemas

  • Establecer rastreador, estado, prioridad

  • Configurar campos personalizados

  • Añadir comentarios

• Eliminar problemas

Proyectos

• Buscar proyectos

  • Filtrar por estado activo/archivado/cerrado

  • Búsqueda de palabras clave

• Obtener detalles del proyecto

  • Incluye rastreadores, información de categorías

• Crear/actualizar proyectos

  • Configurar módulos y rastreadores

  • Herencia de miembros del conjunto

• Archivar/Desarchivar proyectos

• Eliminar proyectos

Entradas de tiempo

• Entradas de tiempo de búsqueda

  • Filtrar por proyecto, usuario, rango de fechas

• Obtener detalles de entrada de tiempo

• Crear/actualizar entradas de tiempo

  • Registrar contra proyecto o problema

  • Especificar actividad

  • Soporte de campos personalizados

• Eliminar entradas de tiempo

Related MCP server: Redmine MCP Server

Uso con Claude

Para utilizar este servidor con Claude, configúrelo de la siguiente manera:

{
  "mcp-server-redmine": {
    "command": "npx",
    "args": [
      "-y",
      "--prefix",
      "/path/to/mcp-server-redmine",
      "mcp-server-redmine"
    ],
    "env": {
      "REDMINE_HOST": "https://your-redmine.example.com",
      "REDMINE_API_KEY": "your-api-key-here"
    }
  }
}

Opciones de configuración

• command : Comando para ejecutar el paquete npm

• args :

  • -y : Responder automáticamente "sí" a las solicitudes

  • --prefix : Especifica el directorio de instalación

  • El último argumento especifica el nombre del paquete.

• env : Variables de entorno

  • REDMINE_HOST : URL del servidor Redmine

  • REDMINE_API_KEY : Su clave API de Redmine

Configuración

Obtener una clave API

1. Habilitar la API REST en la configuración de administración de Redmine

2. Obtener la clave API desde la página de configuración del usuario

Variables de entorno

Establezca las siguientes variables de entorno:

• REDMINE_API_KEY : Clave API obtenida de la configuración del usuario de Redmine

• REDMINE_HOST : URL del servidor Redmine (por ejemplo, https://redmine.example.com )

Pruebas

Pruebas unitarias

# Run tests
npm test

Para la seguridad de los datos, solo se incluyen operaciones GET en las pruebas.

Pruebas de inspectores

Utilice MCP Inspector para verificar la funcionalidad:

# Build
npm run build

# Set execute permission (important)
chmod +x dist/index.js

# Launch inspector
npx @modelcontextprotocol/inspector dist/index.js

Permisos

Algunas funciones requieren privilegios de administrador:

Operaciones relacionadas con el usuario

• list_users : Se requiere administrador

• create_user : Se requiere administrador

• update_user : Se requiere administrador

• delete_user : Se requiere administrador

La información disponible varía según los niveles de permisos del usuario. Para más información, consulte la documentación de la API de Redmine .

Desarrollo

Requisitos

• Node.js 18 o superior

• npm 9 o superior

Bibliotecas

• @modelcontextprotocol/sdk : SDK de MCP

• zod : Validación de esquema

• typescript : Sistema de tipos

Estructura del directorio

.
├── src/
│   ├── tools/            # Tool definitions
│   │   ├── issues.ts
│   │   ├── projects.ts
│   │   ├── time_entries.ts
│   │   └── index.ts
│   ├── formatters/       # Formatters
│   │   ├── issues.ts
│   │   ├── projects.ts
│   │   ├── time_entries.ts
│   │   └── index.ts
│   ├── lib/             # Common libraries
│   │   ├── client.ts     # Redmine API client
│   │   ├── config.ts     # Configuration management
│   │   └── types.ts      # Type definitions
│   ├── handlers.ts       # Request handlers
│   └── index.ts         # Entry point
├── docs/
│   └── adr/             # Architecture Decision Records
├── package.json         # Project configuration
├── tsconfig.json        # TypeScript configuration
└── README.md           # Documentation

Edificio

# Install dependencies
npm install

# Build
npm run build

# Start development server
npm run dev

Registros de decisiones de arquitectura

Las decisiones de diseño más importantes se documentan en docs/adr . Consulte estos documentos al añadir o modificar funciones.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Proyectos relacionados

• Protocolo de contexto modelo

• SDK de TypeScript para MCP

• Mina roja