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

运行服务器

# 作为 STDIO 服务器（AI 集成的默认设置）
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
npm start

# 作为 HTTP/SSE 服务器
MCP_TRANSPORT=sse \
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
npm start

Docker 用法

# 构建
docker build -t bitbucket-mcp-server .

# 运行
docker run --rm -i \
  -e ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
  -e ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
  bitbucket-mcp-server

环境变量

• 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 文件。