Skip to main content
Glama
Redmine MCP Server

Redmine MCP Server

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

Bereich

Tools

Issues

list, get, create, update, delete, add watcher, remove watcher

Projekte

list, get, create, update, delete, archive, unarchive

Suche

Volltextsuche über alle Redmine-Ressourcen

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

Problem

Lösung

„Umgebungsvariable REDMINE_URL fehlt“

Stellen Sie sicher, dass REDMINE_URL im env-Block der MCP-Konfiguration gesetzt ist.

„Umgebungsvariable REDMINE_API_KEY fehlt“

Stellen Sie sicher, dass REDMINE_API_KEY im env-Block der MCP-Konfiguration gesetzt ist.

„Authentifizierung fehlgeschlagen: ungültiger oder abgelaufener API-Schlüssel“

Überprüfen Sie, ob Ihr API-Schlüssel in Redmine → Mein Konto → API-Zugriffsschlüssel korrekt ist.

„Verbindung fehlgeschlagen“

Überprüfen Sie, dass REDMINE_URL von Ihrem Rechner aus erreichbar ist.

Tools erscheinen nicht in Kiro

Bestätigen Sie, dass die Datei mcp.json am richtigen Ort liegt und "disabled" auf false gesetzt ist.

„Git-Programm nicht gefunden“

Git ist nicht installiert oder nicht im PATH. Verwenden Sie stattdessen die zip-basierte Installation oder installieren Sie Git und starten Sie Ihr Terminal neu.

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

Available Tools

17 tools
add_watcherAdd WatcherC

Add a watcher to an issue.

Inputs: user_id (required), issue_id (required). Returns: object

archive_projectArchive ProjectC

Archive a project.

Inputs: project_id (required). Returns: object

create_issueCreate IssueC

Create a new issue in a project.

Inputs: subject (required), project_id (required), status_id, done_ratio, +11 more. Returns: object

create_projectCreate ProjectD

Create a new project.

Inputs: name (required), identifier (required), homepage, is_public, +9 more. Returns: object

delete_issueDelete IssueC

Delete an issue permanently.

Inputs: issue_id (required). Returns: object

delete_projectDelete ProjectC

Delete a project permanently.

Inputs: project_id (required). Returns: object

get_issueGet IssueC

Get detailed information about a specific issue.

Inputs: issue_id (required), include. Returns: object

get_projectGet ProjectC

Get detailed information about a specific project.

Inputs: project_id (required), include. Returns: object

get_time_entryGet Time EntryC

Get detailed information about a specific time entry.

Inputs: time_entry_id (required). Returns: object

list_issuesList IssuesC

List issues with optional filters and pagination.

Inputs: sort, limit, offset, fetch_all, +6 more. Returns: object

list_projectsList ProjectsB

List all accessible projects with pagination.

Inputs: limit, offset, include. Returns: object

list_time_entriesList Time EntriesB

List time entries with optional filters and pagination.

Inputs: limit, offset, to_date, user_id, +4 more. Returns: object

remove_watcherRemove WatcherC

Remove a watcher from an issue.

Inputs: user_id (required), issue_id (required). Returns: object

unarchive_projectUnarchive ProjectC

Unarchive a project.

Inputs: project_id (required). Returns: object

update_issueUpdate IssueD

Update an existing issue.

Inputs: issue_id (required), notes, subject, due_date, +15 more. Returns: object

update_projectUpdate ProjectC

Update an existing project.

Inputs: project_id (required), name, homepage, is_public, +9 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 17 tools

    Disambiguation4/5

    Most tools target a distinct resource+action pair (issues, projects, watchers, time entries), making boundaries clear. The generic 'search' tool mildly overlaps with filtered list_issues/list_projects, but descriptions keep them separable.

    Naming Consistency5/5

    Every tool follows a strict verb_noun convention: list_/get_/create_/update_/delete_/add_/remove_/archive_/unarchive_ plus a clear resource noun. Highly predictable with no deviations.

    Tool Count4/5

    17 tools sits at the heavier end of the range but is justified by covering multiple resources: full issue CRUD, project CRUD plus archive/unarchive, watchers, and time entries. Nothing feels redundant.

    Completeness4/5

    Issues and projects have full lifecycle coverage including archive/unarchive and watchers. Time entries only support read (list/get) with no create/update/delete, a notable gap for a time-tracking-centric tool like Redmine.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers