youtrack-mcp

Ein MCP-Server für YouTrack, gebaut mit TypeScript und Bun. Er funktioniert mit jeder YouTrack-Instanz (Cloud oder selbst gehostet) — du gibst die Basis-URL und einen API-Token an, nichts ist hartkodiert.

Einrichtung

Du benötigst ein permanentes Token für YouTrack: Gehe in YouTrack zu deinem Profil → Kontosicherheit → Neues Token....

Setze zwei Umgebungsvariablen:

• YOUTRACK_BASE_URL — die REST-API-Basis-URL deiner Instanz, z. B. https://mycompany.youtrack.cloud/api oder https://youtrack.mycompany.com/api für selbst gehostete Installationen.

• YOUTRACK_TOKEN — das permanente Token.

Installiere die Abhängigkeiten mit Bun:

bun install

Direkt ausführen

YOUTRACK_BASE_URL=https://mycompany.youtrack.cloud/api YOUTRACK_TOKEN=perm:xxxx bun run src/index.ts

In einem MCP-Client konfigurieren

Zum Beispiel in der mcp.json von Claude Code / Claude Desktop:

{
  "mcpServers": {
    "youtrack": {
      "command": "bun",
      "args": ["run", "/path/to/youtrack-mcp/src/index.ts"],
      "env": {
        "YOUTRACK_BASE_URL": "https://mycompany.youtrack.cloud/api",
        "YOUTRACK_TOKEN": "perm:xxxx"
      }
    }
  }
}

Related MCP server: YouTrack MCP

Werkzeuge

Die Werkzeuge sind nach Ressource gruppiert und teilen sich ein fields-Argument (die Partial-Response-Syntax von YouTrack) mit einer sinnvollen Standardeinstellung, sodass du es nur angeben musst, wenn du mehr oder weniger Daten zurückerhalten möchtest.

• Vorgänge — list_issues (Suche), get_issue, create_issue, update_issue, delete_issue, execute_command (wendet jeden YouTrack-Befehl an — Status, Bearbeiter, Priorität, Verknüpfungen, Tags, Sprint usw. über seine natürliche Abfragesyntax, z. B. "State Fixed assignee John.Doe")

• Kommentare — list_issue_comments, add_issue_comment, update_issue_comment, delete_issue_comment

• Verknüpfungen — list_issue_links, list_issue_link_types

• Tags — list_tags, create_tag, list_issue_tags, add_issue_tag, remove_issue_tag

• Zeiterfassung — list_issue_work_items, add_issue_work_item, update_issue_work_item, delete_issue_work_item, list_work_items

• Projekte — list_projects, get_project, create_project, update_project, list_project_custom_fields

• Benutzer & Gruppen — get_current_user, list_users, get_user, list_groups

• Wissensdatenbank — list_articles, get_article, create_article, update_article, delete_article

• Agile Boards — list_agile_boards, get_agile_board, list_sprints, get_sprint

• Gespeicherte Suchen — list_saved_queries

• Notausstieg — youtrack_raw_request ruft jeden Endpunkt der YouTrack REST API direkt auf (Methode, Pfad, Abfrage, Body), für die lange Liste von Admin-/Einstellungs-Endpunkten, die von keinem dedizierten Werkzeug abgedeckt werden.

Design

• src/youtrack/client.ts — der einzige Ort, der HTTP spricht: Auth-Header, URL-/Abfrage-Aufbau, JSON- und Fehlerbehandlung. Jedes Werkzeug läuft darüber.

• src/youtrack/fields.ts — Standardvorgaben für fields pro Entität, übernommen aus den OpenAPI-Standardwerten von YouTrack.

• src/youtrack/params.ts — gemeinsame Zod-Schema-Fragmente (fields, Paginierung, IDs), die über mehrere Werkzeuge hinweg wiederverwendet werden.

• src/tool.ts — defineTool + registerTools, sodass jede Tool-Datei nur einen Namen/eine Beschreibung/ein Schema/einen Handler deklariert und das MCP-Antwort-/Fehler-Wrapping an einer Stelle erfolgt.

• src/youtrack/tools/*.ts — eine Datei pro Ressource, jedes Werkzeug nur wenige Zeilen, aufgebaut auf den oben genannten gemeinsamen Bausteinen.

Entwicklung

bun run typecheck   # tsc --noEmit
bun run dev         # run with --watch