← 返回目录
A

Atlassian Dc MCP Jira

社区
连接 Atlassian Jira Data Center 的标准 MCP 服务器
分类
团队协作 第 11 / 55
Stars
★ 103 热门
传输方式
stdio(本地进程)
运行环境
Node.js 18+
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
60FMRS · C

这是一个功能性的 MCP 服务器,用于将 Jira Data Center 集成到 AI 助手中。它提供了必要的配置指南和安全存储凭证的方法。但是,它并非官方产品,且工具名称未在文档中明确列出。

最强项 · 安全与权限 15/20 最弱项 · 维护活跃度 8/20

可靠性
9/20
安全与权限
15/20
维护活跃度
8/20
文档质量
14/20
安装易用性
14/20
查看各项评分依据
可靠性 9/20
清单格式完整,stdio 传输和 JIRA_* 环境变量定义清楚;README 描述了可安装的 npm 包和配置优先级。但未提供包源码、测试或 CI 工作流,无法验证 MCP 初始化握手、工具列表与实际行为是否一致,错误处理也缺乏可检查证据。按 0-20 锚点,happy path 尚可但测试/边界不足,且证据缺失压低分数,故给 9。
安全与权限 15/20
设计层面有良好实践:macOS 钥匙串保存令牌、Linux 权限 0600、钥匙串写入后清除家目录中的令牌行、配置优先级文档化、示例中无真实令牌;工具仅限搜索/查看/创建,无可逆的删除/支付类危险操作。扣分点:没有源码可核实最小权限实现和数据流,创建操作无显式确认机制,共享配置文件的边界由用户负责;未达 20 分满分的证据要求,故给 15。
维护活跃度 8/20
仓库未归档,采用 MIT 许可证,版本 0.9.0,README 详细,显示社区维护迹象。但缺少提交/发布日期、依赖更新记录、安全响应渠道;开放问题 3 个但状态未知,维护活跃度无法从现有材料确证,故给 8。
文档质量 14/20
README 分层清晰:快速设置、CLI 参数、配置优先级、平台差异、Claude Desktop/Code 配置示例、令牌生成步骤均有覆盖。但缺少每个工具的参数文档、故障排除章节,也基本未涉及限制/成本;文档本身可信但不能替代可验证证据,故给 14。
安装易用性 14/20
安装路径清晰:要求 Node 18+,运行 `npx @atlassian-dc-mcp/jira setup` 后可零环境变量启动;提供了 Claude Desktop 和 Claude Code 的配置样例,并有 Windows/macOS/Linux 说明。但静态校准要求有真实 CI 与针对服务器的测试才能给到 15 以上;材料中无此类可执行证据,故给 14。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

  • 使用 Atlassian Jira Data Center 的组织
  • 希望通过 AI 助手管理 Jira 问题的团队
  • 需要在本地或私有环境中集成 Jira 的用户

不适合谁

  • 使用 Jira Cloud(非数据中心版)的用户
  • 需要官方支持或保证的用户
  • 没有 Jira Data Center 实例或没有 API 令牌的用户

所需权限

  • 需要 Jira Personal Access Token (PAT)
  • 令牌权限取决于你在 Jira 中配置的范围
  • 通常需要读取问题的权限,创建问题则需要写入权限

风险与副作用

  • 令牌可能会被泄露,如果配置文件中明文存储
  • 社区维护的项目可能缺乏及时的安全更新
  • 使用个人访问令牌时,如果权限过大,可能对 Jira 实例造成风险

安装接入

准备工作

运行环境:Node.js 18+

JIRA_API_TOKEN 可选密钥 Jira Data Center 的 Personal Access Token,在 Jira 实例 Profile > Personal Access Tokens 中生成;也可通过 npx @atlassian-dc-mcp/jira setup 交互式保存。
其他可选配置项(3 个)
ATLASSIAN_DC_MCP_CONFIG_FILE 可选 可选;指向一个共享 dotenv 配置文件的绝对路径,文件缺失时服务器会启动失败。
JIRA_HOST 可选 Jira 实例的域名(如 your-instance.atlassian.net),不带协议;与 JIRA_API_BASE_PATH 二选一。
JIRA_API_BASE_PATH 可选 完整的 API 基础 URL(如 https://your-instance.atlassian.net/rest),可替代 JIRA_HOST。
  1. 确保已安装 Node.js 18 或更高版本,以及 npm 7 或更高版本。
  2. 通过 npx 运行快速设置命令:npx @atlassian-dc-mcp/jira setup,该命令会引导你输入主机、API 基础路径和令牌,并在保存前验证它们。
  3. 或者,可以通过环境变量直接配置:设置 JIRA_HOST(或 JIRA_API_BASE_PATH)和 JIRA_API_TOKEN。
  4. 在你的 MCP 客户端(如 Claude Desktop)中添加如下配置:
{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "JIRA_HOST": "your-jira-host",
        "JIRA_API_TOKEN": "your-token"
      }
    }
  }
}
  1. 如果使用共享配置文件,设置 ATLASSIAN_DC_MCP_CONFIG_FILE 环境变量指向该文件。
claude_desktop_config.json
{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": [
        "-y",
        "@atlassian-dc-mcp/jira"
      ],
      "env": {
        "JIRA_HOST": "your-jira-host",
        "JIRA_API_TOKEN": "your-token"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": [
        "-y",
        "@atlassian-dc-mcp/jira"
      ],
      "env": {
        "JIRA_HOST": "your-jira-host",
        "JIRA_API_TOKEN": "your-token"
      }
    }
  }
}

写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。

Terminal
claude mcp add atlassian-jira-dc -e JIRA_HOST=your-jira-host -e JIRA_API_TOKEN=your-token -- npx -y @atlassian-dc-mcp/jira

在终端运行;先把 <…> 占位符换成你自己的值。

验证是否装好

在 Claude Desktop 配置中添加该服务器后启动客户端,确认工具列表中出现 Jira 相关的搜索、查看和创建 issue 工具,然后让它搜索任一关键词以验证连接。

常见排障

  1. 确保 `JIRA_HOST` 或 `JIRA_API_BASE_PATH` 正确设置,且不包含协议或 API 路径部分
  2. 验证 `JIRA_API_TOKEN` 是否有效,可以通过 `npx @atlassian-dc-mcp/jira setup --non-interactive` 测试
  3. 如果使用共享配置文件,确保 `ATLASSIAN_DC_MCP_CONFIG_FILE` 是绝对路径且文件存在
  4. 检查网络连接,确保服务器能访问 Jira 实例

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 搜索我们 Jira 实例中所有标记为 bug 的未解决 issue
  • 查看 issue JIRA-123 的详细内容和评论
  • 在项目 JIRA 中创建一个新 issue,标题为“修复登录超时”,类型为 Bug
  • 列出分配给当前用户的待办 issue

使用场景

在 AI 助手中搜索 Jira 问题
查看 Jira 问题的详细信息
创建新的 Jira 问题

支持客户端

Claude Desktop
Claude Code

依据项目文档列出,未经本站实测。

详细介绍

这是一个社区维护的 MCP 服务器,用于连接 Atlassian Jira Data Center 实例,提供搜索、查看和创建问题的功能。它通过个人访问令牌(PAT)进行身份验证,适用于自托管的 Jira 数据中心环境。该服务器并非 Atlassian 官方产品,使用时需自行承担风险。

同类可选方案

源版本 f12476955c0d 数据同步于 2026-10-12 查看 FMRS 评分方法