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:

Related MCP server: MCP Alchemy

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