mcp比特桶直流
](https://pypi.org/project/mcp-bitbucket-dc/) ](https://pypi.org/project/mcp-bitbucket-dc/) ](https://pepy.tech/project/mcp-bitbucket-dc)   
MCP（模型上下文协议）服务器 比特桶数据中心。使AI助手能够通过标准化界面搜索代码、浏览文件、管理拉取请求和探索存储库。
建于 FastMCP 在Python中。通过安装 uvx.
致谢
快速开始
1.生成个人访问令牌
- 登录您的Bitbucket数据中心实例
- 首选 管理账户→ HTTP访问令牌
- 点击 创建令牌
- 设置权限： 存储库读取 （以及 写 如果你需要公关创建/评论）
- 复制令牌
2.配置IDE
添加到MCP配置(mcp.json 在VS码中， claude_desktop_config.json 克劳德桌面版）：
{
"mcpServers": {
"bitbucket-dc": {
"command": "uvx",
"args": ["mcp-bitbucket-dc"],
"env": {
"BITBUCKET_HOST": "git.yourcompany.com",
"BITBUCKET_API_TOKEN": "your-personal-access-token"
}
}
}
}就是这样。当IDE连接时，服务器会自动启动。
3.开始使用
问你的AI助手：
- *“在代码库中搜索CompanyInfoUpdater”*
- *“显示PROJECT中api服务仓库的文件结构”*
- *“从仓库后端获取src/main/Application.java的内容”*
- *“在PROJECT/my repo中列出打开的拉取请求”*
- *“PROJECT/我的回购中存在哪些分支？”*
工具参考
大多数读取/查询工具支持 response_format:
markdown（默认）：人类可读输出json：原始结构化API响应
代码搜索
| 工具 | 说明 |
|---|---|
bitbucket_code_search | 使用Lucene语法在所有存储库中搜索代码(ext:java, lang:python, repo:name, project:KEY, AND/OR/NOT) |
文件浏览
| 工具 | 说明 |
|---|---|
bitbucket_browse | 浏览目录树（路径中的文件和文件夹） |
bitbucket_get_file_content | 通过语法高亮显示获取原始文件内容 |
bitbucket_list_files | 递归列出存储库中的所有文件路径 |
bitbucket_get_branches | 列出分支（可过滤） |
bitbucket_get_tags | 列表标签（可过滤） |
bitbucket_create_branch | 从分支、标记或提交创建新分支 |
项目和存储库
| 工具 | 说明 |
|---|---|
bitbucket_get_projects | 列出项目（可按名称/权限筛选） |
bitbucket_get_project | 获取项目详细信息 |
bitbucket_search_repositories | 在所有项目中搜索仓库（不需要项目密钥） |
bitbucket_get_repositories | 列出项目中的存储库 |
bitbucket_get_repository | 使用克隆URL获取仓库详细信息 |
拉取请求
| 工具 | 说明 |
|---|---|
bitbucket_get_pull_requests | 列出PR（按状态、方向、文本过滤） |
bitbucket_get_pull_request | 与审阅者一起获取PR详细信息 |
bitbucket_get_pull_request_comments | 获取公关评论和活动 |
bitbucket_get_pull_request_changes | 在PR中更改文件 |
bitbucket_get_pull_request_diff | 获取PR中文件的差异 |
bitbucket_post_pull_request_comment | 发表评论（一般或内联） |
bitbucket_update_pull_request_comment | 更新现有的PR评论 |
bitbucket_delete_pull_request_comment | 删除PR评论 |
bitbucket_create_pull_request | 创建新的PR |
bitbucket_update_pull_request | 更新PR标题/描述/审阅者 |
bitbucket_get_required_reviewers | 获取分支对所需的审阅者 |
提交
| 工具 | 说明 |
|---|---|
bitbucket_get_commits | 列表提交（按路径、引用范围筛选） |
bitbucket_get_commit | 获取单个提交的完整细节 |
bitbucket_get_commit_diff | 获取特定提交的差异 |
搜索查询语法
这 bitbucket_code_search 该工具使用Lucene风格的查询：
# Simple text search
CompanyInfoUpdater
# Filter by file extension
function ext:java
# Filter by language
config lang:python
# Filter by repository or project
DatabaseHelper repo:backend-api
service project:PLATFORM
# Filter by path
controller path:src/main
# Boolean operators (must be UPPERCASE)
config AND (yaml OR yml)
test NOT unit
UserService AND ext:java AND project:CORE配置
| 环境变量 | 必填 | 说明 |
|---|---|---|
BITBUCKET_HOST | 是\* | Bitbucket DC主机名（例如。 git.company.com) |
BITBUCKET_URL | 是\* | 全基URL替代方案（例如。 https://git.company.com) |
BITBUCKET_API_TOKEN | 是 | 个人访问令牌 |
\*提供其中之一 BITBUCKET_HOST 或 BITBUCKET_URL不是两者都有。
支持矩阵
| 组件 | 版本 | 验证 |
|---|---|---|
| Bitbucket数据中心 | 8.19.5 | 实时烟雾测试在本地针对真实服务器运行 |
| Python运行时 | 3.10、3.11、3.12、3.13 | GitHub操作CI(test 工作流矩阵） |
如果您在不同的Bitbucket DC版本上运行，请打开一个带有结果的问题。
替代交通工具
# SSE transport (for remote/multi-user setups)
uvx mcp-bitbucket-dc --transport sse --host 0.0.0.0 --port 8000
# Streamable HTTP
uvx mcp-bitbucket-dc --transport streamable-http --host 0.0.0.0 --port 8000默认情况下，基于HTTP的传输绑定到 127.0.0.1 为了更安全的地方发展。
发展
# Clone and install
git clone https://github.com/christopherekfeldt/mcp-bitbucket-dc.git
cd mcp-bitbucket-dc
uv sync
# Install git hooks
uv run pre-commit install
# Run locally
export BITBUCKET_HOST=git.yourcompany.com
export BITBUCKET_API_TOKEN=your-token
uv run mcp-bitbucket-dc
# Run tests
uv run pytest
# Run live smoke tests against a real/staging Bitbucket DC
# (requires BITBUCKET_HOST or BITBUCKET_URL + BITBUCKET_API_TOKEN)
RUN_LIVE_SMOKE=1 uv run pytest -m integration -q贡献者/代理工作流程指南：请参阅 代理商.md.
版本控制和稳定性
该项目如下 语义化版本从v1.0.0开始，工具名称、所需参数和输出契约都是稳定的——只有在主要版本发生变化时才会中断更改。
升级： uvx mcp-bitbucket-dc 总是使用最新的。带有 uvx mcp-bitbucket-dc==X.Y.Z.
发行说明： 看 用于更新日志。
许可证
麻省理工学院——见 许可证.