AI导哈

Jira与Bitbucket集成服务

一个本地MCP服务器，连接Atlassian Jira和Bitbucket Cloud，用于获取Jira票证详情、创建基于票证的Git分支、创建Bitbucket拉取请求并分配审查者。

  • by SodhanaLibrary
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 SodhanaLibrary/jira-bitbucket-mcp-server

使用说明

Jira+比特桶MCP服务器

本地人 MCP（模型上下文协议） 连接到的服务器 Atlassian Jira 和 比特桶云 致：

  1. 获取Jira门票详细信息 按发行密钥
  2. 创建一个git分支 根据Jira票证命名（例如。 feature/PROJ-123-add-login)
  3. 创建Bitbucket拉取请求 从那个分支
  4. 分配审稿人 致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 build

2.环境变量

复制示例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": "<your-jira-api-token>",
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_REPO_SLUG": "your-repo",
        "BITBUCKET_API_TOKEN": "<your-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中。

典型工作流程

  1. 买票: get_jira_ticket 随着 issueKey: "PROJ-123"。如果问题有附件（如图像），请使用 get_jira_attachment 每一个 attachments[].id 因此AI可以获取并查看它们。
  2. 创建分支: create_branch 随着 issueKey: "PROJ-123"，可选 slug: "add-login" （从repo根或set运行 repoDir).
  3. 进行更改 在您的仓库中（手动或使用Cursor）。
  4. 创建PR: create_pull_request 随着 title, sourceBranch （您创建的分支），可选 description.
  5. 分配审稿人: assign_pr_reviewers 随着 pullRequestId （从步骤4开始）和 reviewerUsernames: ["user1", "user2"].

发展

npm run dev   # Run with tsx (no build)
npm run build # Compile to dist/

许可证

麻省理工学院

相关 MCP