Jira Server MCP

MCP-Server ohne Abhängigkeiten für selbstgehostetes Jira Server / Data Center – funktioniert mit Jira 8.x einschließlich Versionen vor 8.14 (kein Personal Access Token erforderlich).

Der MCP-Server für Jira Server / Data Center ist vollständig abhängigkeitsfrei und mit der Python-Standardbibliothek umgesetzt. Es muss kein Drittanbieterpaket per pip install installiert werden; Python 3.8+ genügt.

Warum das nötig ist

• Der offizielle Atlassian-MCP-Server unterstützt nur Jira Cloud, keine lokale Bereitstellung.

• Das gängige Open-Source-Paket mcp-atlassian setzt Jira Server 8.14+ voraus, weil es Personal Access Tokens (PAT) benötigt.

• Viele Unternehmen setzen weiterhin 8.13 und ältere Versionen ein, ohne PAT, und können daher nur Basic Auth (Benutzername + Passwort) verwenden.

• Dieser Server unterstützt sowohl Basic Auth als auch PAT und deckt damit alle 8.x-Versionen ab.

Related MCP server: jira-mcp

Verfügbare Tools

Umgebungsvariablen

Authentifizierung. Ist JIRA_TOKEN gesetzt, wird ein Bearer Token (PAT) verwendet; andernfalls erfolgt die Anmeldung per Basic Auth mit JIRA_USERNAME + JIRA_PASSWORD.

Installation und Ausführung

Wählen Sie eine der drei Möglichkeiten:

# 方式一：pipx 安装（推荐，全局可用 jira-server-mcp 命令）
pipx install git+https://github.com/zhao1749501038/jira-server-mcp

# 方式二：uvx 直接运行（不落盘）
uvx --from git+https://github.com/zhao1749501038/jira-server-mcp jira-server-mcp

# 方式三：直接运行源码（零依赖，连 pip 都不用）
git clone https://github.com/zhao1749501038/jira-server-mcp
python3 jira-server-mcp/jira_mcp_server.py

Anbindung an MCP-Clients

WorkBuddy

~/.workbuddy/mcp.json:

{
  "mcpServers": {
    "jira": {
      "command": "/usr/bin/python3",
      "args": ["/path/to/jira_mcp_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://jira.yourcompany.com",
        "JIRA_USERNAME": "your-username",
        "JIRA_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

claude mcp add --scope user jira \
  --env JIRA_BASE_URL=https://jira.yourcompany.com \
  --env JIRA_USERNAME=your-username --env JIRA_PASSWORD=your-password \
  -- /usr/bin/python3 /path/to/jira_mcp_server.py

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "/usr/bin/python3",
      "args": ["/path/to/jira_mcp_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://jira.yourcompany.com",
        "JIRA_USERNAME": "your-username",
        "JIRA_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json, wie bei Claude Desktop.

Codex

~/.codex/config.toml:

[mcp_servers.jira]
command = "/usr/bin/python3"
args = ["/path/to/jira_mcp_server.py"]
env = { JIRA_BASE_URL = "https://jira.yourcompany.com", JIRA_USERNAME = "your-username", JIRA_PASSWORD = "your-password" }

Sicherheitshinweis

• Zugangsdaten liegen im Klartext in der Client-Konfiguration; bitte nicht in Git einchecken. Bei Empfehlung ein separates Bot-Konto mit minimalen Berechtigungen verwenden (nur Ansehen/Erstellen/Bearbeiten/Kommentieren/Statusübergang/Zuweisen, keine Lösch- und Systemverwaltungsrechte).

• Bei der Nutzung durch mehrere Personen empfiehlt es sich, den Server als HTTP-MCP-Server mit zentraler Authentifizierung bereitzustellen, anstatt dass jeder Benutzer eigene Passwörter speichert.

Lizenz

MIT