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. 05支持 STDIO 和 HTTP/SSE 传输

适用场景

  1. 01让 AI 系统检索 Bitbucket 仓库
  2. 02查看项目分支和文件
  3. 03通过工具处理拉取请求

MCP 相关

该 MCP 服务向 AI 系统提供 Bitbucket 项目、仓库、分支、文件和拉取请求的访问工具。

#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 系统集成的模型上下文协议（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（推荐）

此项目包含一个 Makefile，可简化 Docker 操作：

# 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 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。