MCP Redmine

MCP Redmine

Estado: Funciona muy bien y se utiliza a diario sin errores conocidos.

Estado 2: Acabo de añadir el paquete a PyPI y actualicé las instrucciones de uso. Por favor, informen cualquier problema.

¡Deja que Claude sea tu asistente de Redmine! MCP Redmine conecta Claude Desktop con tu instancia de Redmine, lo que le permite:

• Busque y explore proyectos y problemas
• Crear y actualizar problemas con soporte completo de Markdown
• Cargar y descargar archivos adjuntos
• Gestionar y realizar un seguimiento de las entradas de tiempo
• Actualizar estados y campos de problemas
• Acceda a la funcionalidad completa de la API de Redmine

Utiliza httpx para solicitudes de API y se integra con la especificación Redmine OpenAPI para una cobertura de API integral.

Instalación

Asegúrese de tener instalado el sistema UV:

Uso con Claude Desktop

Añade a tu claude_desktop_config.json :

Variables de entorno

• REDMINE_URL : URL de su instancia de Redmine (obligatorio)
• REDMINE_API_KEY : Su clave API de Redmine (obligatoria, vea a continuación cómo obtenerla)
• REDMINE_REQUEST_INSTRUCTIONS : Ruta a un archivo que contiene instrucciones adicionales para la herramienta redmine_request (opcional)

Cómo obtener su clave API de Redmine

1. Inicie sesión en su instancia de Redmine
2. Vaya a "Mi cuenta" (normalmente se encuentra en el menú superior derecho)
3. En el lado derecho de la página, debería ver "Clave de acceso API".
4. Haga clic en "Mostrar" para ver su clave existente o en "Generar" para crear una nueva
5. Copie esta clave para usarla en su configuración

API

Herramientas

• lista de rutas de redmine
  • Devuelve una lista de rutas de API disponibles desde la especificación OpenAPI
  • No se requiere entrada
  • Devuelve una cadena YAML que contiene una lista de plantillas de ruta: GXP3
• información de rutas de redmine
  • Obtener información de ruta completa para las plantillas de ruta dadas
  • Entrada: path_templates (lista de cadenas)
  • Devuelve la cadena YAML que contiene las especificaciones de API para las rutas solicitadas: GXP4
• solicitud de redmine
  • Realizar una solicitud a la API de Redmine
  • Entradas:
    • path (cadena): ruta del punto final de la API (por ejemplo, '/issues.json')
    • method (cadena, opcional): método HTTP a utilizar (predeterminado: 'get')
    • data (objeto, opcional): Diccionario para el cuerpo de la solicitud (para POST/PUT)
    • params (objeto, opcional): Diccionario para parámetros de consulta
  • Devuelve una cadena YAML que contiene el código de estado de la respuesta, el cuerpo y el mensaje de error: GXP5
• redmine_upload
  • Sube un archivo a Redmine y obtén un token por adjuntarlo
  • Entradas:
    • file_path (cadena): ruta completa al archivo a cargar
    • description (cadena, opcional): descripción opcional para el archivo
  • Devuelve una cadena YAML con el mismo formato que redmine_request, incluido el token de carga: GXP6
• descarga de redmine
  • Descargue un archivo adjunto de Redmine y guárdelo en un archivo local
  • Entradas:
    • attachment_id (entero): El ID del archivo adjunto para descargar
    • save_path (cadena): ruta completa donde se debe guardar el archivo
    • filename (cadena, opcional): nombre de archivo opcional a utilizar (se determina automáticamente si no se proporciona)
  • Devuelve la cadena YAML con los resultados de la descarga: GXP7

Ejemplos

Creando un nuevo problema

Buscando problemas

Actualización del estado del problema

Tiempo de registro

Contribuyendo

¡Agradecemos cualquier contribución! Ya sean informes de errores, solicitudes de funciones, mejoras en la documentación o contribuciones de código, todas las aportaciones son valiosas. No dudes en:

• Abra un problema para informar errores o sugerir funciones
• Enviar solicitudes de extracción con mejoras
• Mejore la documentación o comparta sus ejemplos de uso
• Haz preguntas y comparte tus experiencias

El objetivo es hacer que la gestión de proyectos de Redmine con Claude sea aún mejor, y sus conocimientos y contribuciones ayudan a lograrlo.

Expresiones de gratitud

Este proyecto se basa en el excelente trabajo de otros:

• httpx - Para gestionar solicitudes HTTP
• Especificación OpenAPI de Redmine : para obtener la especificación API completa
• Redmine - La aplicación web flexible para la gestión de proyectos

Desarrollo

Primero clona el repositorio de github e instala las dependencias:

Luego configure esto en claude_desktop_config.json:

Licencia

Licencia pública de Mozilla versión 2.0

Mis otros proyectos de LLM

• MCP Alchemy : conecta Claude Desktop a bases de datos para explorar esquemas y ejecutar SQL.
• MCP Notmuch Sendmail - Asistente de correo electrónico para Claude Desktop que utiliza notmuch.
• Diffpilot - Visor de diferencias Git de varias columnas con agrupación y etiquetado de archivos.
• Archivos locales de Claude : acceda a archivos locales en los artefactos de Claude Desktop.