Jira+比特桶MCP服务器
本地人 MCP（模型上下文协议） 连接到的服务器 Atlassian Jira 和 比特桶云 致：
- 获取Jira门票详细信息 按发行密钥
- 创建一个git分支 根据Jira票证命名（例如。
feature/PROJ-123-add-login) - 创建Bitbucket拉取请求 从那个分支
- 分配审稿人 致PR
从Cursor（或任何MCP客户端）使用它来驱动工作流：获取票证→ 创建分支→ 进行更改（在您的仓库中）→ 公开公关→ 分配审阅者。
______________________________________________________________________
先决条件
- Node.js 18+
- Jira：来自的API令牌 Atlassian帐户
- 比特桶：来自的API令牌 Atlassian帐户 （存储库/拉取请求范围）
- Git 在PATH（for
create_branch)
______________________________________________________________________
设置
1.安装
cd jira-bitbucket-mcp-server
npm install
npm run build2.环境变量
复制示例env并填写您的值：
cp .env.example .env
# Edit .env with your Jira and Bitbucket credentials| 变量 | 必填 | 描述 |
|---|---|---|
JIRA_BASE_URL | 是 | Jira基本URL，例如。 https://your-domain.atlassian.net |
JIRA_EMAIL | 是 | 用于Jira的电子邮件 |
JIRA_API_TOKEN | 是 | Jira API令牌 |
BITBUCKET_WORKSPACE | 对于PR | Bitbucket工作区（团队/用户段） |
BITBUCKET_REPO_SLUG | 对于PR | 存储库段塞 |
BITBUCKET_API_TOKEN | 对于PR | Bitbucket API令牌（存储库+拉取请求范围） |
3.添加到光标MCP
在光标中，打开 设置→ MCP 并添加新服务器。a示例 本地stdio 服务器：
光标MCP配置 （例如在 ~/.cursor/mcp.json 或通过光标UI）：
{
"mcpServers": {
"jira-bitbucket": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/jira-bitbucket-mcp-server/dist/index.js"],
"env": {
"JIRA_BASE_URL": "https://your-domain.atlassian.net",
"JIRA_EMAIL": "you@example.com",
"JIRA_API_TOKEN": "",
"BITBUCKET_WORKSPACE": "your-workspace",
"BITBUCKET_REPO_SLUG": "your-repo",
"BITBUCKET_API_TOKEN": ""
}
}
}
}替换 ABSOLUTE/PATH/TO/jira-bitbucket-mcp-server 与真实路径（例如。 /Users/you/Documents/workspace-2/jira-bitbucket-mcp-server).不希望在JSON中放入秘密；你可以走了 env 空虚，依赖 .env Cursor启动时，项目或shell环境中的文件。
______________________________________________________________________
工具
| 工具 | 说明 |
|---|---|
| 获取jira_ticket | 按密钥获取Jira问题（例如。 PROJ-123).返回摘要、描述、状态、链接和 附件 （id、文件名、mimeType、大小）。 |
| get_jira_attachment | 通过附件id获取附件内容（例如图像）。返回base64数据URL，以便AI可以查看图像。使用来自的ID get_jira_ticket → attachments. |
| create_branch | 根据工单创建并签出一个名为的分支，例如。 feature/PROJ-123-add-login。可选的slug和branch前缀。 |
| create_pull_request | 创建从源分支到目标分支的Bitbucket PR（默认 main). |
| assign_pr_viewers | 通过Bitbucket用户名将审阅者添加到现有PR中。 |
______________________________________________________________________
典型工作流程
- 买票:
get_jira_ticket随着issueKey: "PROJ-123"。如果问题有附件（如图像），请使用 get_jira_attachment 每一个attachments[].id因此AI可以获取并查看它们。 - 创建分支:
create_branch随着issueKey: "PROJ-123"，可选slug: "add-login"（从repo根或set运行repoDir). - 进行更改 在您的仓库中（手动或使用Cursor）。
- 创建PR:
create_pull_request随着title,sourceBranch（您创建的分支），可选description. - 分配审稿人:
assign_pr_reviewers随着pullRequestId（从步骤4开始）和reviewerUsernames: ["user1", "user2"].
______________________________________________________________________
发展
npm run dev # Run with tsx (no build)
npm run build # Compile to dist/______________________________________________________________________
许可证
麻省理工学院