Atlassian Bitbucket MCP Server

@aashari

リポジトリ

基本情報

カテゴリ

バージョン管理

トランスポート

stdio

作者

aashari

Atlassian Bitbucket MCP Server について

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.

#cli #typescript #tools #ai #server #repository #tooling #version-control #mcp #bitbucket #pull-request #atlassian #claude #llm #anthropic #ai-integration #ai-connector #model-context-protocol #mcp-server

Atlassian Bitbucket MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp-server-atlassian-bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-bitbucket",
        "get",
        "--path",
        "/workspaces"
      ]
    }
  }
}

Atlassian Bitbucket MCP Server のツール

GET any Bitbucket API endpoint (read data)

POST to any endpoint (create resources)

PUT to any endpoint (replace resources)

PATCH any endpoint (partial updates)

DELETE any endpoint (remove resources)

Clone a repository locally

概要

What is Atlassian Bitbucket MCP Server?

Atlassian Bitbucket MCP Server connects AI assistants like Claude and Cursor AI directly to Bitbucket Cloud repositories, pull requests, and code. It allows developers, team leads, and DevOps engineers to interact with Bitbucket using natural language for code reviews, repository management, and workflow automation.

How to use Atlassian Bitbucket MCP Server?

Configure your MCP-compatible AI assistant to run npx -y @aashari/mcp-server-atlassian-bitbucket with environment variables for authentication. For Claude Desktop, add the server configuration to ~/.claude/claude_desktop_config.json. Set credentials via ATLASSIAN_USER_EMAIL plus ATLASSIAN_API_TOKEN (recommended) or ATLASSIAN_BITBUCKET_USERNAME plus ATLASSIAN_BITBUCKET_APP_PASSWORD. Optionally set BITBUCKET_DEFAULT_WORKSPACE in a config file at ~/.mcp/configs.json.

Key features of Atlassian Bitbucket MCP Server

Provides 6 generic tools (bb_get, bb_post, bb_put, bb_patch, bb_delete, bb_clone) for Bitbucket API access
Supports TOON output format reducing token consumption by 30-60% vs JSON
Includes JMESPath (jq) filtering to extract specific data and reduce costs
Supports branching, commits, pull requests, diffs, comments, approvals, and merges
Offers scoped API token (future-proof) and legacy app password authentication methods
Works with any MCP-compatible client including Claude Desktop, Cursor AI, Continue.dev, and Cline

Use cases of Atlassian Bitbucket MCP Server

Ask AI about latest commits, open pull requests, or repository details in natural language
Automate code reviews by having AI analyze PR diffs and add comments
Manage pull requests—create, approve, merge, decline, or request changes via conversation
Generate quick insights into project status, branch activity, and deployment pipelines

よくある質問

What are the runtime requirements?

Node.js 18.0.0 or higher and a Bitbucket Cloud account (not Bitbucket Server/Data Center).

How do I authenticate?

Use a scoped API token (recommended, future-proof) or an App Password (legacy, deprecated by June 2026). For tokens, set `ATLASSIAN_USER_EMAIL` and `ATLASSIAN_API_TOKEN`. For app passwords, set `ATLASSIAN_BITBUCKET_USERNAME` and `ATLASSIAN_BITBUCKET_APP_PASSWORD`.

What APIs and endpoints are available?

All Bitbucket Cloud REST API 2.0 endpoints are accessible. Common paths include workspaces, repositories, branches, commits, pull requests, diffs, comments, approvals, merges, issues, pipelines, and deployments.

How is this different from alternatives?

Generic tools give access to any Bitbucket API endpoint without being locked to predefined actions. TOON output format and JMESPath filtering reduce token costs significantly compared to raw JSON responses.