AI导哈

Jira MCP桥接服务

将Jira REST API操作暴露为本地MCP服务器，供AI代理使用，支持Jira Cloud和Data Center的不同认证模式。

  • by berilevi
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 berilevi/Jira-MCP-Bridge

使用说明

Jira MCP桥

该项目将Jira REST API操作公开为任何AI代理都可以使用的本地MCP服务器。

何时使用此

在以下情况下使用此桥：

  • 您有Jira API令牌或个人访问令牌
  • Jira不公开官方MCP端点
  • Claude/VS Code可以启动本地MCP服务器

交通流量为：

Claude/VS Code -> local MCP server -> Jira REST API

Jira类型：云与数据中心

可靠的检查是Jira的服务器信息端点，而不仅仅是主机名：

  • GET /rest/api/3/serverInfo
  • 退路： GET /rest/api/2/serverInfo

这座桥包括 jira_detect_instance 为您运行该检查的工具。

实用提示：

  • Jira Cloud经常使用 *.atlassian.net，但存在自定义域，因此这不是最终的。
  • Jira Cloud API令牌身份验证使用您的Atlassian电子邮件加令牌作为基本身份验证。
  • Jira数据中心或服务器个人访问令牌通常使用承载身份验证。

支持的身份验证模式

如果您不确定，请从以下方面开始：

export JIRA_AUTH_MODE="auto"

大桥将使用：

  • 云基本身份验证 JIRA_EMAIL 已设置
  • 承载PAT身份验证 JIRA_EMAIL 未设置

代币本身通常告诉您：

  • 如果您在Atlassian帐户安全设置中创建了令牌，并且您还有Atlassian账户电子邮件，则通常是Jira Cloud。
  • 如果您在自托管的Jira实例中创建了个人访问令牌，通常是Jira数据中心或服务器。

吉拉云

设置：

export JIRA_BASE_URL="https://your-domain.atlassian.net"
export JIRA_AUTH_MODE="cloud_basic"
export JIRA_EMAIL="you@example.com"
export JIRA_TOKEN="your-api-token"

Jira数据中心/服务器

设置：

export JIRA_BASE_URL="https://your-jira-instance"
export JIRA_AUTH_MODE="dc_pat"
export JIRA_TOKEN="your-personal-access-token"
unset JIRA_EMAIL

可用工具

  • jira_detect_instance
  • jira_whoami
  • jira_list_projects
  • jira_search_issues
  • jira_get_issue
  • jira_create_issue
  • jira_update_issue
  • jira_add_comment
  • jira_list_transitions
  • jira_transition_issue

设置

安装依赖项并构建：

npm install
npm run build

然后：

  1. 将服务器直接添加到Claude：
claude mcp add jira-bridge -e JIRA_BASE_URL="$JIRA_BASE_URL" -e JIRA_AUTH_MODE="$JIRA_AUTH_MODE" -e JIRA_EMAIL="$JIRA_EMAIL" -e JIRA_TOKEN="$JIRA_TOKEN" -- node /home/beri/projects/jira/dist/index.js
  1. 或编辑 .mcp.json 使用您的真实值，让客户端加载项目MCP配置。

VS代码+GitHub副本（远程SSH）

当VS Code在另一台机器上运行并通过远程SSH连接到Linux主机时，请使用此设置。

先决条件

  • VS代码1.99+ GitHub Copilot 和 GitHub Copilot 聊天助手 扩展
  • chat.mcp.enabled 着手 true 在VS代码设置中
  • 远程SSH连接到Linux主机

1.在远程主机上克隆和构建

SSH进入主机并运行：

mkdir -p ~/projects && cd ~/projects
git clone https://github.com/berilevi/Jira-MCP-Bridge.git
cd Jira-MCP-Bridge
npm install
npm run build

2.在远程主机上设置凭据

添加 ~/.bashrc 在远程机器上：

export JIRA_BASE_URL="https://your-jira-instance"
export JIRA_AUTH_MODE="dc_pat"          # or cloud_basic
export JIRA_TOKEN="your-token"
# export JIRA_EMAIL="you@example.com"   # only for cloud_basic

然后重新加载： source ~/.bashrc

3.在VS代码中配置MCP

连接远程SSH后，运行 Ctrl+Shift+P → MCP: Add Server 并填写：

  • 类型： 标准
  • 命令： node
  • Args： /home/<user>/projects/Jira-MCP-Bridge/dist/index.js
  • 姓名： jira-bridge
  • 保存到： 远程设置

这创造了 /home/<user>/.vscode-server/data/User/mcp.json:

{
  "servers": {
    "jira-bridge": {
      "type": "stdio",
      "command": "node",
      "args": ["/home/<user>/projects/Jira-MCP-Bridge/dist/index.js"]
    }
  }
}

4.验证和使用

  • Ctrl+Shift+P → MCP: List Servers --确认 jira-bridge 显示为正在运行
  • 打开Copilot聊天(Ctrl+Alt+I) → 切换到 代理 模式
  • 点击🔧 输入栏中的工具图标-- jira-bridge 将列出工具
  • 自然地问： “显示我打开的Jira门票” 或 “PROJ-123的状态如何？”

VS Code将MCP服务器作为远程主机上的子进程生成，因此它继承了shell环境并自动获取凭据——配置文件中不需要令牌。

备注

  • 尽可能将令牌保存在环境变量中。
  • 对于Jira Cloud富文本注释，该桥会自动将纯文本转换为Atlassian文档格式。
  • 发布创建和更新工具接受原始Jira fields 和 update payloads，因此您可以在不更改网桥的情况下使用自定义字段。

相关 MCP