Atlassian AI Toolkit

AI-ориентированный SDK, CLI и MCP-сервер для Atlassian Jira и Confluence

Монорепозиторий Bun, содержащий типизированный SDK, агент-нативный CLI и MCP-сервер для облачных API Atlassian.

Пакеты

Related MCP server: MCP Atlassian

Установка CLI

Рекомендуемый способ: автономный бинарный файл

Без Node.js, без npm, без конфликтов PATH. Один файл, собранный с помощью Bun.

macOS и Linux:

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

Скрипт определяет вашу ОС и архитектуру, загружает подходящий бинарный файл из последнего релиза, проверяет его SHA256 и устанавливает в $HOME/.local/bin/atlassian.

Зафиксируйте версию с помощью ATLASSIAN_AI_TOOLKIT_VERSION=v0.1.0 или измените каталог установки с помощью ATLASSIAN_AI_TOOLKIT_INSTALL=$HOME/bin.

Windows: загрузите atlassian-windows-x64.exe из последнего релиза и добавьте его в ваш PATH.

Доступные бинарные файлы: atlassian-linux-{x64,arm64}, atlassian-darwin-{x64,arm64} и atlassian-windows-x64.exe.

Обновление

Обновите установленный бинарный файл на месте из последнего релиза GitHub (сначала проверяется SHA256):

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

В Windows закройте запущенные экземпляры перед обновлением или повторно загрузите exe из последнего релиза.

Псевдонимы оболочки

Для более коротких команд добавьте эти псевдонимы в профиль вашей оболочки (~/.zshrc или ~/.bashrc):

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

Затем jira get PROJ-123 выполняет atlassian jira get PROJ-123, а conf get 123456 выполняет atlassian confluence get 123456.

Настройка

Укажите учетные данные Atlassian Cloud в вашей оболочке:

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

Создайте API-токен с ограниченными правами на https://id.atlassian.com/manage-profile/security/api-tokens.

Вложения

Загрузите один или несколько файлов в задачу Jira. Повторите --file для нескольких загрузок; сохраненное имя файла — это базовое имя файла, а тип MIME определяется по его расширению.

# 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

Инструмент MCP jira_add_attachment принимает те же paths, плюс массив files для контента, который агент генерирует встроенно (filename, content, encoding: utf8 | base64).

Страницы Confluence принимают одно вложение за вызов:

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

Вложения должны быть включены на сайте, и загрузки подлежат максимальному размеру вложения на сайте.

Деструктивные действия

Удаление по умолчанию выполняется в режиме предпросмотра. Фактическое удаление требует --force и соответствующего значения --confirm из полученного ресурса.

# 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

Начало работы из исходного кода

# 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

Токен должен быть ограничен минимальным набором разрешений Jira и Confluence, необходимым для рабочего процесса. Сторонние эталонные реализации находятся в refs/, который намеренно игнорируется git, чтобы этот репозиторий никогда не включал и не выполнял непроверенный код с локальными учетными данными.

Архитектура

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

И CLI, и MCP-сервер являются тонкими обертками над SDK. Если REST API изменится, вы обновляете SDK, и оба потребителя автоматически получат исправление.

Разработка

# Run tests across all packages
bun test

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

Добавление новой операции API

1. Добавьте типы в packages/sdk/src/types.ts

2. Добавьте метод клиента в packages/sdk/src/client.ts

3. Добавьте команду CLI в packages/cli/src/commands/

4. Добавьте инструмент MCP в packages/mcp/src/tools/

Деструктивные операции должны по умолчанию использовать путь предпросмотра и требовать явного флага --force в CLI или force: true в инструментах MCP.