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//projects/Jira-MCP-Bridge/dist/index.js
• 姓名： jira-bridge
• 保存到： 远程设置

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

{
  "servers": {
    "jira-bridge": {
      "type": "stdio",
      "command": "node",
      "args": ["/home//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，因此您可以在不更改网桥的情况下使用自定义字段。