Mcp Server Wrapper Bitbucket

Atlassian MCP サーバー

Bitbucket Server/Data Center、Jira Cloud、Confluence Cloud 向けのネイティブな非同期 Python MCP サーバーです。各サーバーは各製品の REST API と直接通信し、個別にインストールして実行できます。

パッケージ

パッケージ	API	PyPI 名	ディレクトリ
Bitbucket	Server/Data Center REST API v1.0	bitbucket-mcp-atlassian	リポジトリのルート
Jira	Cloud REST API v3 / Server-DC REST API v2	jira-mcp-atlassian	jira-mcp/
Confluence	Cloud REST API v2 / Server-DC REST API v2	confluence-mcp-atlassian	confluence-mcp/

Jira と Confluence のパッケージは自己完結型のプロジェクトで、それぞれ独自の pyproject.toml、テスト、環境設定のサンプル、リリースメタデータを備えています。

クイックスタート

uv をインストールし、使用するパッケージを設定して、その MCP エントリーポイントを実行します。

Bitbucket Server/Data Center

cp .env.example .env
uv sync
uv run bitbucket-mcp

BITBUCKET_URL を設定し、BITBUCKET_TOKEN、または BITBUCKET_USERNAME と BITBUCKET_PASSWORD の両方を設定します。

Jira Cloud

cd jira-mcp
cp .env.example .env
uv sync
uv run jira-mcp

JIRA_URL、JIRA_EMAIL、JIRA_TOKEN を設定します。トークンは、メールアドレスに関連付けられた Atlassian API トークンです。

Confluence Cloud

cd confluence-mcp
cp .env.example .env
uv sync
uv run confluence-mcp

CONFLUENCE_URL、CONFLUENCE_EMAIL、CONFLUENCE_TOKEN を設定します。

各サーバーは、対応する *_TRANSPORT 設定を通じて stdio、sse、streamable-http トランスポートをサポートします。TLS 検証、タイムアウト、再試行の動作は、環境ファイルで設定できます。

MCP 設定例

{
  "mcpServers": {
    "bitbucket": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/this-repo", "bitbucket-mcp"],
      "env": {
        "BITBUCKET_URL": "https://bitbucket.example.com",
        "BITBUCKET_TOKEN": "your-token"
      }
    },
    "jira": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/this-repo/jira-mcp", "jira-mcp"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_TOKEN": "your-token"
      }
    },
    "confluence": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/this-repo/confluence-mcp", "confluence-mcp"],
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "[email protected]",
        "CONFLUENCE_TOKEN": "your-token"
      }
    }
  }
}

機能

Bitbucket は、プロジェクト、リポジトリ、プルリクエスト、コメント、レビュー、差分、ブランチ、コミット、ファイル、ユーザー、権限、ビルドステータスのツールを提供します。

Jira は、JQL による課題検索、課題の取得と更新、課題の作成／削除、コメント、トランジション、担当者の割り当て、プロジェクト、課題タイプを提供します。Cloud ではリッチテキストに ADF を使用し、Server/Data Center では Jira wiki マークアップを使用します。

Confluence は、Cloud と Server/Data Center の両方で、ページの一覧表示、取得、作成、更新、削除、スペース、子ページ、ラベル、コメントを提供します。

開発とテスト

リポジトリのルートから、既存の Bitbucket テストを実行します。

uv run pytest

独立した Atlassian Cloud テストスイートは、それぞれのパッケージディレクトリから実行します。

cd confluence-mcp && uv run pytest
cd ../jira-mcp && uv run pytest

すべてのテストはモックされた HTTP トランスポートを使用し、Atlassian サービスには接続しません。

ビルドと公開

個別のパッケージは、そのディレクトリからビルドします。

cd jira-mcp
uv build

ルートのリリースワークフローは、一致するタグがプッシュされると、PyPI の信頼された公開を通じてパッケージを公開します。

git tag jira-v0.1.0
git push origin jira-v0.1.0

git tag confluence-v0.1.0
git push origin confluence-v0.1.0

リリースタグをプッシュする前に、リポジトリの pypi GitHub 環境と信頼された公開元を設定してください。各リリースワークフローは、PyPI の短期間有効な OIDC 認証情報を使用します。長期間有効な PyPI トークンは GitHub に保存されません。

アーキテクチャ

src/bitbucket_mcp/             Bitbucket Server/Data Center implementation
jira-mcp/src/jira_mcp/          Jira Cloud implementation
confluence-mcp/src/confluence_mcp/  Confluence Cloud implementation

Each package follows the same structure:
  client.py   async HTTP and authentication infrastructure
  config.py   pydantic-settings environment configuration
  tools.py    REST API capability functions
  server.py   FastMCP tool registration and transport entrypoint