MCP Redmine

MCP Redmine

Status: Funktioniert einwandfrei und ist im täglichen Einsatz ohne bekannte Fehler.

Status2: Ich habe das Paket gerade zu PyPI hinzugefügt und die Gebrauchsanweisung aktualisiert. Bitte melden Sie etwaige Probleme. :)

Machen Sie Claude zu Ihrem Redmine-Assistenten! MCP Redmine verbindet Claude Desktop mit Ihrer Redmine-Instanz und ermöglicht ihm so:

• Suchen und Durchsuchen von Projekten und Problemen
• Erstellen und aktualisieren Sie Probleme mit vollständiger Markdown-Unterstützung
• Dateianhänge hochladen und herunterladen
• Zeiteinträge verwalten und verfolgen
• Aktualisieren von Problemstatus und Feldern
• Greifen Sie auf umfassende Redmine-API-Funktionen zu

Verwendet httpx für API-Anfragen und integriert sich in die Redmine OpenAPI-Spezifikation für eine umfassende API-Abdeckung.

Installation

Stellen Sie sicher, dass Sie UV installiert haben:

Verwendung mit Claude Desktop

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

Umgebungsvariablen

• REDMINE_URL : URL Ihrer Redmine-Instanz (erforderlich)
• REDMINE_API_KEY : Ihr Redmine-API-Schlüssel (erforderlich, siehe unten, wie Sie ihn erhalten)
• REDMINE_REQUEST_INSTRUCTIONS : Pfad zu einer Datei mit zusätzlichen Anweisungen für das Tool redmine_request (optional). Ich habe festgestellt, dass es sehr gut funktioniert, wenn das LLM diese Datei nach einer Sitzung generiert. ( Beispiel1 Beispiel2 )

Abrufen Ihres Redmine-API-Schlüssels

1. Melden Sie sich bei Ihrer Redmine-Instanz an
2. Gehen Sie zu „Mein Konto“ (normalerweise im Menü oben rechts zu finden)
3. Auf der rechten Seite der Seite sollten Sie „API-Zugriffsschlüssel“ sehen.
4. Klicken Sie auf „Anzeigen“, um Ihren vorhandenen Schlüssel anzuzeigen, oder auf „Generieren“, um einen neuen zu erstellen.
5. Kopieren Sie diesen Schlüssel zur Verwendung in Ihrer Konfiguration

API

Werkzeuge

• Redmine_Pfadliste
  • Gibt eine Liste der verfügbaren API-Pfade aus der OpenAPI-Spezifikation zurück
  • Keine Eingabe erforderlich
  • Gibt einen YAML-String zurück, der eine Liste von Pfadvorlagen enthält: GXP3
• Redmine_Pfade_Info
  • Vollständige Pfadinformationen für angegebene Pfadvorlagen abrufen
  • Eingabe: path_templates (Liste von Zeichenfolgen)
  • Gibt eine YAML-Zeichenfolge mit API-Spezifikationen für die angeforderten Pfade zurück: GXP4
• Redmine_Anfrage
  • Stellen Sie eine Anfrage an die Redmine-API
  • Eingänge:
    • path (Zeichenfolge): API-Endpunktpfad (z. B. „/issues.json“)
    • method (Zeichenfolge, optional): Zu verwendende HTTP-Methode (Standard: „get“)
    • data (Objekt, optional): Wörterbuch für den Anforderungstext (für POST/PUT)
    • params (Objekt, optional): Wörterbuch für Abfrageparameter
  • Gibt eine YAML-Zeichenfolge mit Antwortstatuscode, Text und Fehlermeldung zurück: GXP5
• redmine_upload
  • Laden Sie eine Datei auf Redmine hoch und erhalten Sie ein Token für den Anhang
  • Eingänge:
    • file_path (Zeichenfolge): Vollständiger Pfad zur hochzuladenden Datei
    • description (Zeichenfolge, optional): Optionale Beschreibung für die Datei
  • Gibt eine YAML-Zeichenfolge im gleichen Format wie redmine_request zurück, einschließlich Upload-Token: GXP6
• Redmine_Download
  • Laden Sie einen Anhang von Redmine herunter und speichern Sie ihn in einer lokalen Datei
  • Eingänge:
    • attachment_id (Ganzzahl): Die ID des herunterzuladenden Anhangs
    • save_path (Zeichenfolge): Vollständiger Pfad, in dem die Datei gespeichert werden soll
    • filename (Zeichenfolge, optional): Optionaler zu verwendender Dateiname (wird automatisch ermittelt, wenn nicht angegeben)
  • Gibt den YAML-String mit den Download-Ergebnissen zurück: GXP7

Beispiele

Erstellen eines neuen Problems

Suchen nach Problemen

Aktualisieren des Problemstatus

Protokollierungszeit

MCP-Verzeichniseinträge

MCP Redmine ist in den folgenden MCP-Verzeichnisseiten und -Repositorys aufgeführt:

• MCP.so
• Glama

Entwicklung

Klonen Sie zuerst das GitHub-Repository und installieren Sie die Abhängigkeiten:

Legen Sie dann Folgendes in claude_desktop_config.json fest:

Meine anderen LLM-Projekte

• MCP Alchemy – Verbinden Sie Claude Desktop mit Datenbanken, um Schemata zu erkunden und SQL auszuführen.
• MCP Notmuch Sendmail – E-Mail-Assistent für Claude Desktop mit Notmuch.
• Diffpilot – Mehrspaltiger Git-Diff-Viewer mit Dateigruppierung und -markierung.
• Lokale Claude-Dateien – Greifen Sie auf lokale Dateien in Claude-Desktop-Artefakten zu.

Beitragen

Beiträge sind herzlich willkommen! Ob Fehlerberichte, Funktionswünsche, Dokumentationsverbesserungen oder Codebeiträge – jeder Input ist wertvoll. Fühlen Sie sich frei:

• Öffnen Sie ein Problem, um Fehler zu melden oder Funktionen vorzuschlagen
• Senden Sie Pull Requests mit Verbesserungen
• Erweitern Sie die Dokumentation oder teilen Sie Ihre Anwendungsbeispiele
• Stellen Sie Fragen und teilen Sie Ihre Erfahrungen

Das Ziel besteht darin, das Redmine-Projektmanagement mit Claude noch besser zu machen, und Ihre Erkenntnisse und Beiträge tragen dazu bei, dies zu erreichen.

Danksagung

Dieses Projekt baut auf der hervorragenden Arbeit anderer auf:

• httpx – Zur Verarbeitung von HTTP-Anfragen
• Redmine OpenAPI Spezifikation - Für die umfassende API Spezifikation
• Redmine – Die flexible Projektmanagement-Webanwendung

Lizenz

Mozilla Public License Version 2.0