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
Python 3.10+ auf Ihrem Rechner installiert
uv – ein schneller Python-Paketmanager (Installationsanleitung)
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
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.comdurch Ihre Redmine-URLyour-api-key-heredurch 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 |
„Umgebungsvariable REDMINE_API_KEY fehlt“ | Stellen Sie sicher, dass |
„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 |
Tools erscheinen nicht in Kiro | Bestätigen Sie, dass die Datei |
„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]"
pytestAvailable Tools
17 toolsadd_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
searchSearchD
Search across Redmine resources.
Inputs: query (required), news, limit, scope, +10 more. 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
Scored across 17 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server for AI dialogue using various LLM models via AceDataCloud
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that integrates with Discord to provide AI-powered features.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Redmine issues, projects, time tracking, wiki, and files via the MCP protocol.3325 npm6Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server for Redmine that enables interaction with issues, wiki pages, and time entries through natural language.ISC
- AlicenseAqualityCmaintenanceMCP server for Redmine integration, enabling AI assistants to manage issues, upload files, automate workflows, and handle wiki pages.18MIT
- FlicenseAqualityDmaintenanceAn MCP server that connects AI agents to Redmine project data, enabling natural language access to issues, projects, time entries, and more via the REST API.21-