Redmine MCP Server

Ein MCP (Model Context Protocol) Server, der KI-Assistenten wie Kiro mit Ihrer Redmine-Instanz verbindet. Er stellt 15 Tools für Issues, Projekte und Suche bereit – so kann Ihr KI-Assistent Issues erstellen, Projekte aktualisieren, in Ressourcen suchen und mehr – alles über natürliche Konversation.

Was es tut

Nach der Konfiguration können Sie Ihren KI-Assistenten zum Beispiel Folgendes fragen:

• „Alle offenen Issues auflisten, die mir zugewiesen sind“

• „Einen Fehlerbericht für den Absturz der Anmeldeseite erstellen“

• „Nach Issues im Zusammenhang mit Datenbankmigration suchen“

• „Das Projekt old-website archivieren“

• „John als Beobachter zu Issue #42 hinzufügen“

Der Server übernimmt Authentifizierung, Paginierung, Eingabevalidierung und Fehlerbehandlung automatisch.

Related MCP server: @a-bonus/redmine-mcp

Verfügbare Tools

Voraussetzungen

1. Python 3.10+ auf Ihrem Rechner installiert

2. uv – ein schneller Python-Paketmanager (Installationsanleitung)

   • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

   • Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. Redmine-API-Schlüssel – erhalten Sie Ihren von Ihrer Redmine-Instanz:

   • Melden Sie sich bei Redmine an

   • Gehen Sie zu Mein Konto (Menü oben rechts)

   • Suchen Sie in der rechten Seitenleiste nach API-Zugriffsschlüssel und klicken Sie auf Anzeigen

   • Kopieren Sie den Schlüssel

Einrichtung mit Kiro

Schritt 1: Fügen Sie die MCP-Server-Konfiguration zu Kiro hinzu

Erstellen oder bearbeiten Sie ~/.kiro/settings/mcp.json (dadurch wird es für alle Ihre Projekte verfügbar):

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/bizcloud-experts/redmine-mcp-server.git", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Ersetzen Sie:

• https://your-redmine-instance.com durch Ihre Redmine-URL

• your-api-key-here durch Ihren Redmine-API-Schlüssel

Sie können diese Datei auch in .kiro/settings/mcp.json in einem bestimmten Arbeitsbereich ablegen, wenn Sie sie nur dort verfügbar machen möchten.

Schritt 2: Öffnen Sie Kiro

Der MCP-Server startet automatisch, wenn Kiro gestartet wird. Sie können überprüfen, ob er funktioniert, indem Sie fragen: „Listen Sie meine Redmine-Projekte auf.“

Alternative: Wenn git nicht installiert ist

Wenn Sie einen Fehler „Git executable not found“ erhalten, können Sie eine zip-basierte Installation verwenden, die kein git auf Ihrem Rechner erfordert:

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "redmine-mcp-server @ https://github.com/bizcloud-experts/redmine-mcp-server/archive/refs/heads/main.zip", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Alternative Einrichtung: Lokale Installation

Wenn Sie es vorziehen, von einem lokalen Klon statt von uvx aus zu laufen:

git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install .

Verwenden Sie dann stattdessen diese MCP-Konfiguration:

{
  "mcpServers": {
    "redmine": {
      "command": "/absolute/path/to/redmine-mcp/.venv/bin/redmine-mcp-server",
      "args": [],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Fehlerbehebung

Entwicklung

git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest