Integrations
Provides authentication and integration with Atlassian services, specifically focused on Bitbucket functionality using Atlassian API tokens.
Allows AI assistants to interact with Bitbucket repositories, including listing repositories, accessing pull requests, viewing commit information, and exploring workspaces.
アトラシアン Bitbucket MCP サーバー
このプロジェクトは、AIアシスタント(AnthropicのClaude、Cursor AI、その他のMCP対応クライアントなど)とAtlassian Bitbucketインスタンス間のブリッジとして機能するModel Context Protocol(MCP)サーバーを提供します。これにより、AIはリポジトリ、プルリクエスト、ワークスペースに安全にアクセスし、リアルタイムで操作できるようになります。
概要
MCPとは何ですか?
モデル コンテキスト プロトコル (MCP) は、AI システムが外部ツールやデータ ソースに安全かつコンテキストに応じて接続できるようにするオープン スタンダードです。
このサーバーは Bitbucket Cloud 専用の MCP を実装し、Bitbucket データを AI アシスタントと連携させます。
このサーバーを使用する理由
- 最小限の入力、最大限の出力という理念:
workspaceSlug
やrepoSlug
といったシンプルな識別子だけで十分です。各ツールは、追加のフラグを必要とせずに包括的な詳細情報を返します。 - 豊富なコードの視覚化: ファイル統計、差分ビュー、コード変更に関するスマートなコンテキストを使用して、リポジトリとコードの変更に関する詳細な情報を取得します。
- 安全なローカル認証:認証情報はサーバーに保存されません。サーバーはローカルで実行されるため、トークンはユーザーのマシンから外部に流出することはなく、必要な権限のみを要求できます。
- 直感的なマークダウン応答: すべての応答では、一貫した書式とナビゲーション リンクを使用して読みやすくするために、適切に構造化されたマークダウンが使用されています。
- 完全な Bitbucket 統合: 統合されたインターフェースを通じて、ワークスペース、リポジトリ、プル リクエスト、コメント、コード検索などにアクセスできます。
はじめる
前提条件
- Node.js (>=18.x):ダウンロード
- Bitbucket クラウドアカウント
ステップ1: 認証
次のいずれかの認証方法を選択します。
オプション A: Bitbucket アプリのパスワード (推奨)
Bitbucket App Passwordsから生成します。最小権限:
- ワークスペース: 読み取り
- リポジトリ: 読む
- プルリクエスト: 読む
オプションB: Atlassian APIトークン
Atlassian API トークンから生成します。
注: Atlassian アカウントシステムの共有により、サーバーは Atlassian API トークン(標準のATLASSIAN_*
変数経由)を使用して機能する可能性がありますが、この統合ではBitbucket アプリパスワードの使用が強く推奨され、公式にサポートされています。アプリパスワードを使用すると、よりきめ細かな Bitbucket 固有の権限スコープを設定できるため、スコープが広い可能性のある API トークンと比較してセキュリティが強化されます。
ステップ2: 資格情報を構成する
方法 A: MCP 構成ファイル (推奨)
~/.mcp/configs.json
を作成または編集します。
Bitbucket アプリパスワードの使用:
Atlassian API トークンの使用:
**注:**後方互換性のため、サーバーは完全なパッケージ名 ( @aashari/mcp-server-atlassian-bitbucket
)、スコープ指定のないパッケージ名 ( mcp-server-atlassian-bitbucket
)、または推奨されるbitbucket
キーが見つからない場合はatlassian-bitbucket
形式でも構成を認識します。ただし、新しい構成では短縮形のbitbucket
キーの使用が推奨されます。
方法B: 環境変数
サーバーを実行するときに資格情報を直接渡します。
ステップ3: AIアシスタントを接続する
このサーバーを起動するには、MCP 互換クライアントを構成します。
クロード / カーソル設定:
この構成では、実行時にサーバーが自動的に起動します。
ツール
このセクションでは、このサーバーをAIアシスタントと併用する際に利用できるMCPツールについて説明します。MCPツールでは、ツール名にsnake_case
、パラメータにcamelCase
が使用されることに注意してください。
bb_ls_workspaces
利用可能な Bitbucket ワークスペースを一覧表示します。
または:
「Bitbucket ワークスペースをすべて表示してください。」
bb_get_workspace
特定のワークスペースの完全な詳細を取得します。
「「acme-corp」ワークスペースについて詳しく教えてください。」
bb_ls_repos
ワークスペース内のリポジトリを一覧表示します。 role
、 projectKey
、 query
(名前/説明)でフィルタリングします。並べ替えとページ区切りをサポートします。
「プロジェクト PROJ の 'acme-corp' 内のリポジトリを一覧表示します。」
bb_get_repo
所有者、メイン ブランチ名、コメント/タスク数、最近の PR など、特定のリポジトリの詳細を取得します。
「「acme-corp」の「backend-api」リポジトリを表示してください。」
bb_search
Bitbucket コンテンツを検索します。 scope
(「リポジトリ」、「プルリクエスト」、「コミット」、「コード」、「すべて」)を指定します。コードスコープはlanguage
とextension
フィルターをサポートします。「すべて」スコープには、どのスコープが結果を返したかを示すヘッダーが含まれます。
コード(フィルタリング済み):
「「acme-corp」ワークスペース内の TypeScript ファイルで「Logger」を検索します。」
bb_ls_prs
リポジトリ内のプル リクエストを一覧表示します。
「'frontend-app' でオープン PR を表示します。」
bb_get_pr
コードの差分、ファイルの変更、コメント/タスクの数など、プル リクエストの詳細を取得します。
「すべてのコード変更を含む PR #42 を 'frontend-app' から取得します。」
bb_ls_pr_comments
特定のプルリクエストに対するコメントを一覧表示します。インラインコメントにはコードスニペットが含まれます。
「インライン コメントのコード コンテキストを含む、PR #42 のすべてのコメントを表示します。」
bb_create_pr_comment
プルリクエストにコメントを追加します。
一般的な:
列をなして:
「PR #42 の 42 行目にコメントを追加します。」
bb_create_pr
新しいプルリクエストを作成します。
「'feature/login' から 'main' への PR を作成します。」
bb_create_branch
ソース ブランチまたはコミットから新しいブランチを作成します。
「'frontend-app' の 'main' からブランチ 'feature/new-feature' を作成します。」
bb_get_commit_history
リポジトリのコミット履歴を取得します。
または(ブランチとパスでフィルタリング):
「'backend-api' リポジトリのコミット履歴を表示してください。」 「UserService.java の develop ブランチのコミットを取得してください。」
コマンドラインインターフェース (CLI)
CLI では、コマンド (例: ls-workspaces
) とオプション (例: --workspace-slug
) にケバブケースが使用されます。
npx
のクイック使用
グローバルにインストール
次に直接実行します:
その他のCLIオプションを見る
使用可能なすべてのコマンドのフラグと使用方法を表示するには、 --help
を使用します。
または、特定のコマンドの詳細なヘルプを取得します。
ライセンス
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Claude のような AI アシスタントがコピー/貼り付け操作を必要とせずに Bitbucket リポジトリ、プル リクエスト、コードに直接アクセスして操作できるようにする統合ツール。
Related MCP Servers
- AsecurityAlicenseAqualityEnables AI assistants to interact with GitHub through the PyGithub library, providing tools for managing issues, repositories, pull requests, and other GitHub operations with intelligent parameter handling and error management.Last updated 2 months ago19PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.Last updated 2 months ago129Python
- -securityFlicense-qualityA Multi-Claude Program for interacting with GitHub APIs through Claude Desktop, allowing users to search repositories, manage issues, pull requests, repository settings, workflows, and collaborators.Last updated a month ago1Python
- -securityFlicense-qualityA Python implementation of an MCP server that enables secure, local Bitbucket integration for AI applications, providing tools for repository management, branch creation, file operations, issue tracking, and pull request creation.Last updated 3 months ago1Python
Appeared in Searches
- A platform for code hosting and collaboration
- Exploring a GitHub repository and creating a detailed flowchart of its functionality
- A server for reading and navigating GitHub repositories using provided URLs
- A platform for managing and hosting Git repositories
- DevSecOps tools for integration with GitLab or development environments