mcpField
A
Atlassian Bitbucket MCP Server

Atlassian Bitbucket MCP Server

ローカル
github.com/guenichoneバージョン管理059 週間前に更新
リポジトリ

Atlassian Bitbucket MCP Server について

Atlassian Bitbucket MCP Serverは、セルフホストのBitbucket Server/Data CenterをAIシステムに接続し、AI経由でリポジトリを扱うチーム向けです。公式OpenAPI仕様に基づく型安全なAPI連携を提供します。

主な機能

  1. 01プロジェクト、リポジトリ、ブランチへのアクセス
  2. 02リポジトリファイルの読み取り
  3. 03プルリクエスト用ツール
  4. 04公式OpenAPI仕様に基づく連携
  5. 05STDIOとHTTP/SSEトランスポート対応

活用シーン

  1. 01AIシステムによるBitbucketリポジトリの確認
  2. 02プロジェクトのブランチとファイルの確認
  3. 03ツールを使ったプルリクエスト対応

MCP 対応

このMCP サーバーは、Bitbucketのプロジェクト、リポジトリ、ブランチ、ファイル、プルリクエストにアクセスするツールをAIシステムに提供します。

#mcp#bitbucket#mcp-server

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "atlassian-bitbucket-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
起動コマンドdocker run -i --rm build

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocibuild

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Atlassian Bitbucket MCP サーバー

Atlassian Bitbucket Server/Data Center と AI システムを統合する Model Context Protocol（MCP）サーバーです。

機能

このサーバーを利用すると、AI システムから Bitbucket リポジトリを操作できます。具体的には、以下の機能を提供します。

  • プロジェクト、リポジトリ、ブランチ、ファイルへのアクセス
  • プルリクエストを操作するツール
  • Bitbucket の公式 OpenAPI 仕様と連携する型安全な API 統合

クイックセットアップ

前提条件
  • Node.js（v20 以降を推奨）
  • npm
  • Python 3（OpenAPI フィルタリングスクリプト用）
  • Bitbucket Server のアクセストークン
インストール
git clone [<atlassian-bitbucket-server-mcp>](https://github.com/guenichone/atlassian-bitbucket-server-mcp)
cd mcp-server-selfhosted-bitbucket
npm install
npm run build-app
サーバーの実行
# As STDIO server (default for AI integration)
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
npm start

# As HTTP/SSE server
MCP_TRANSPORT=sse \
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
npm start

Docker の使用方法

Docker CLI を使用する
# Build
docker build -t bitbucket-mcp-server .

# Run
docker run --rm -i \
  -e ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
  -e ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
  bitbucket-mcp-server
Makefile を使用する（推奨）

このプロジェクトには、Docker 操作を簡単にする Makefile が含まれています。

# Build the Docker image
make docker-build

# Run with your Bitbucket credentials
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-run

# Build and run in one command
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-all

# View all available make commands and examples
make help

環境変数

  • ATLASSIAN_BITBUCKET_SERVER_URL - Bitbucket サーバーの URL
  • ATLASSIAN_BITBUCKET_ACCESS_TOKEN - アクセストークン
  • MCP_TRANSPORT - stdio（デフォルト）または sse
  • PORT - SSE の使用時の HTTP ポート（デフォルト：3000）

謝辞

このプロジェクトは aashari/mcp-server-atlassian-bitbucket に着想を得ています。

ライセンス

MIT - 詳細は LICENSE ファイルを参照してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。