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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

MongoDB
kiliczsh
A
security
A
license
A
quality
A Model Context Protocol server that provides access to MongoDB databases. This server enables LLMs to inspect collection schemas and execute read-only queries.
Last updated -
8
817
217
TypeScript
MIT License
MCP Ethers Wallet
crazyrabbitLTC
A
security
A
license
A
quality
A Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.
Last updated -
31
323
2
TypeScript
MIT License
MCP Database Server
manpreet2000
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.
Last updated -
TypeScript
MIT License
MCP Server RubyGems
6
-
security
F
license
-
quality
A Model Context Protocol server that allows interaction with the RubyGems.org API to fetch metadata about Ruby packages, search gems, and explore dependencies and ownership information.
Last updated -
TypeScript

View all related MCP servers

Redmine MCP Server