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

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

Habilitar la API REST en la configuración de administración de Redmine
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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Un servidor de protocolo de contexto de modelo para interactuar con Redmine utilizando su API REST, lo que permite la gestión de tickets, proyectos y datos de usuarios a través de la integración con LLM.

Related Resources

Reddit Discussion about this server

Related MCP Servers

salesforce-mcp-server
kablewy
A
security
F
license
A
quality
A Model Context Protocol server implementation for interacting with Salesforce through its REST API.
Last updated -
4
10
TypeScript
OneSignal MCP Server
WeirdBrains
-
security
A
license
-
quality
A Model Context Protocol server that wraps the OneSignal REST API, enabling management of push notifications, emails, SMS, user devices, and segments across multiple OneSignal applications.
Last updated -
2
Python
MIT License
Frontapp MCP Server
zqushair
-
security
A
license
-
quality
A Model Context Protocol server that integrates LLMs with Frontapp's customer communication platform, enabling access to conversations, contacts, and tags while supporting real-time updates via webhooks.
Last updated -
TypeScript
MIT License
OpenAPI MCP Server
rahgadda
-
security
A
license
-
quality
A Model Context Protocol Server that enables LLMs to interact with and execute REST API calls through natural language prompts, supporting GET/PUT/POST/PATCH operations on configured APIs.
Last updated -
5
Python
Apache 2.0

View all related MCP servers

Redmine MCP Server