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: MCP Ethers Wallet

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

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Redmine MCP Server