Atlassian AI Toolkit

KI-first SDK, CLI und MCP-Server für Atlassian Jira und Confluence

Ein Bun-Monorepo mit einem typisierten SDK, einer agent-nativen CLI und einem MCP-Server für die Atlassian-Cloud-APIs.

Pakete

Related MCP server: MCP Atlassian

Installation der CLI

Empfohlen: Eigenständige Binärdatei

Kein Node.js, kein npm, keine PATH-Konflikte. Eine einzige Datei, mit Bun erstellt.

macOS und Linux:

curl -fsSL https://raw.githubusercontent.com/spenserhale/atlassian-ai-toolkit/main/scripts/install.sh | sh

Das Skript erkennt Ihr Betriebssystem und Ihre Architektur, lädt die passende Binärdatei aus dem neuesten Release herunter, prüft ihre SHA256-Summe und installiert sie in $HOME/.local/bin/atlassian.

Legen Sie eine Version mit ATLASSIAN_AI_TOOLKIT_VERSION=v0.1.0 fest oder ändern Sie das Installationsverzeichnis mit ATLASSIAN_AI_TOOLKIT_INSTALL=$HOME/bin.

Windows: Laden Sie atlassian-windows-x64.exe vom neuesten Release herunter und legen Sie es in Ihren PATH.

Verfügbare Binärdateien: atlassian-linux-{x64,arm64}, atlassian-darwin-{x64,arm64} und atlassian-windows-x64.exe.

Aktualisierung

Aktualisieren Sie eine installierte Binärdatei an Ort und Stelle aus dem neuesten GitHub-Release (die SHA256-Summe wird zuerst geprüft):

atlassian upgrade            # apply the latest release
atlassian upgrade --dry-run  # only show current vs latest

Unter Windows: Schließen Sie laufende Instanzen, bevor Sie aktualisieren, oder laden Sie die exe-Datei erneut vom neuesten Release herunter.

Shell-Aliase

Für kürzere Befehle fügen Sie diese Aliase Ihrem Shell-Profil (~/.zshrc oder ~/.bashrc) hinzu:

alias jira='atlassian jira'
alias conf='atlassian confluence'

Danach führt jira get PROJ-123 den Befehl atlassian jira get PROJ-123 aus, und conf get 123456 führt den Befehl atlassian confluence get 123456 aus.

Konfiguration

Legen Sie Ihre Atlassian-Cloud-Anmeldedaten in Ihrer Shell fest:

export ATLASSIAN_SITE_URL="https://your-site.atlassian.net"
export ATLASSIAN_EMAIL="you@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

Erstellen Sie ein eingeschränktes API-Token unter https://id.atlassian.com/manage-profile/security/api-tokens.

Anhänge

Laden Sie eine oder mehrere Dateien zu einem Jira-Issue hoch. Wiederholen Sie --file für mehrere Uploads; der gespeicherte Dateiname ist der Basisname der Datei, und der MIME-Typ wird aus der Dateiendung abgeleitet.

# Attach a single file
atlassian jira attach PROJ-123 --file ./screenshot.png

# Attach several files and print the API response
atlassian jira attach PROJ-123 --file ./error.log --file ./har-capture.har --json

Das MCP-Tool jira_add_attachment übernimmt die gleichen paths sowie ein files-Array für Inhalte, die ein Agent inline generiert (filename, content, encoding: utf8 | base64).

Confluence-Seiten akzeptieren einen Anhang pro Aufruf:

atlassian confluence attachment upload --page 123456 --file ./diagram.png

Anhänge müssen auf der Site aktiviert sein, und Uploads unterliegen der maximalen Anhangsgröße der Site.

Destruktive Aktionen

Löschungen werden standardmäßig als Vorschau angezeigt. Die tatsächliche Löschung erfordert --force und einen passenden --confirm-Wert aus der abgerufenen Ressource.

# Preview the permanent Jira delete
atlassian jira delete PROJ-123

# Permanently delete the Jira issue
atlassian jira delete PROJ-123 --force --confirm PROJ-123

# Preview moving a Confluence page to trash
atlassian confluence delete 123456

# Move a Confluence page to trash
atlassian confluence delete 123456 --force --confirm 123456

# Permanently purge an already-trashed Confluence page
atlassian confluence delete 123456 --purge --force --confirm 123456

Erste Schritte aus dem Quellcode

# Install dependencies
bun install

# Build all packages
bun run build

# Run the CLI
bun run dev:cli -- --help

# Run the MCP server (stdio mode for Claude Desktop)
bun run dev:mcp

Das Token sollte auf den kleinsten Satz an Jira- und Confluence-Berechtigungen beschränkt sein, der für den Workflow benötigt wird. Referenzimplementierungen von Drittanbietern liegen unter refs/, das bewusst in .gitignore aufgenommen ist, damit dieses Repository niemals ungeprüften Code einbindet oder mit lokalen Anmeldedaten ausführt.

Architektur

packages/sdk/     <-- Types, API client, business logic (foundation)
    ^       ^
    |       |
packages/cli/   packages/mcp/
    (Stricli)    (FastMCP)

Sowohl die CLI als auch der MCP-Server sind dünne Wrapper um das SDK. Wenn sich die REST-API ändert, aktualisieren Sie das SDK, und beide Anwendungen erhalten den Fix automatisch.

Entwicklung

# Run tests across all packages
bun test

# Build a specific package
cd packages/sdk && bun run build

Hinzufügen einer neuen API-Operation

1. Fügen Sie Typen zu packages/sdk/src/types.ts hinzu.

2. Fügen Sie die Client-Methode zu packages/sdk/src/client.ts hinzu.

3. Fügen Sie einen CLI-Befehl in packages/cli/src/commands/ hinzu.

4. Fügen Sie ein MCP-Tool in packages/mcp/src/tools/ hinzu.

Destruktive Operationen müssen standardmäßig einen Vorschau-Modus verwenden und ein explizites --force-Flag in der CLI oder force: true in MCP-Tools erfordern.