Atlassian Jira MCP Server

社区

将 AI 连接到您的 Jira 项目

分类: 其他
Stars: ★ 77 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 需要 API Key / 凭据
最近提交: 7 个月前 ⚠
工具数: 5

40FMRS · D

该 MCP 服务器提供了对 Jira Cloud 的全面访问，通过通用 HTTP 工具覆盖所有 REST API v3 端点。其 TOON 格式和 JMESPath 过滤功能提高了 AI 交互的效率。但仅支持云版本，且需要用户具备一定的 API 知识。

最强项 · 文档质量 12/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

6/20

维护活跃度

8/20

文档质量

12/20

安装易用性

8/20

查看各项评分依据

可靠性 6/20: 服务器声称提供五个通用工具(jira_get, jira_post等),但README未提供任何测试或CI配置证据。声明使用了MCP SDK v1.23.0和Zod v4,但没有源码或锁文件来验证。因此,能正常启动和完成握手的可能性尚可,但关键路径未被测试覆盖,错误处理和边界条件不明确。基于静态评估,给6分。
安全与权限 6/20: 服务器使用用户提供的API令牌,通过环境变量传递,没有硬编码凭证。然而,工具设计允许任意Jira API调用,包括删除(`jira_delete`),且没有确认机制或作用域限制。虽然数据仅发送到Atlassian服务器,但权限过大。静态审查未发现恶意行为,但由于缺乏源代码和测试,安全姿态不充分。给出6分。
维护活跃度 8/20: 仓库有定期更新(版本3.2.1),依赖于最新包,有发布的npm包。但是,没有许可证或安全响应渠道的证据。存在开放的GitHub问题,但响应情况不明。总体活跃,但治理和许可存在差距,因此得8分。
文档质量 12/20: README非常全面,涵盖安装、认证、工具说明、示例、疑难解答和常见问题。它解释了输出格式和截断行为。然而,它没有提供详细的工具参数或版本兼容性,并且缺乏可验证的技术细节(如源代码或锁文件)。文档清晰,但有些假设未被证实,因此得12分。
安装易用性 8/20: 安装步骤简单:设置环境变量,然后使用npx或npm安装。提供了Claude桌面的配置示例。要求Node.js 18+,这是合理的。但是,没有验证步骤或跨平台测试的证据,而且由于缺少CI和测试,安装可能脆弱。给出8分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

希望快速访问问题详情和开发上下文的开发者
需要跟踪进度、优先级和团队分配的项目经理
需要管理冲刺和工作流状态的 Scrum Master
监控项目健康度和问题解决情况的团队负责人
跟踪缺陷和测试状态的 QA 工程师
任何希望通过自然语言与 Jira 交互的用户

不适合谁

需要 Jira Server 或 Data Center（内部部署）支持的用户——目前仅支持 Jira Cloud
需要预定义专用工具（如 jira_ls_projects）的旧工作流程——v3 迁移为通用 HTTP 工具
期望无需 Jira API 令牌即可使用的用户

所需权限

需要 Atlassian 账户对目标项目具有适当的 Jira 权限
需要有效的 Atlassian API 令牌
服务器在本地运行，使用您自己的凭据

风险与副作用

API 令牌泄露会导致未授权访问——请妥善保管
通用工具可能暴露超出预期的数据，需谨慎使用
API 端点可能发生变更，导致工具失效
对于大型响应，会自动截断，原始数据保存到本地 /tmp/mcp 目录

安装接入

准备工作

运行环境：Node.js 18+

ATLASSIAN_SITE_NAME 必填你的 Jira 站点名，即网址 mycompany.atlassian.net 中的 mycompany 部分。

ATLASSIAN_USER_EMAIL 必填你的 Atlassian 账户登录邮箱。

ATLASSIAN_API_TOKEN 必填密钥在 https://id.atlassian.com/manage-profile/security/api-tokens 生成的 API 令牌，创建后立即复制保存。

在 Atlassian API Tokens 页面创建 API 令牌并复制。
设置环境变量：ATLASSIAN_SITE_NAME（例如 your-company）、ATLASSIAN_USER_EMAIL（您的邮箱）、ATLASSIAN_API_TOKEN（令牌）。
对于 Claude Desktop，将配置添加到 ~/.claude/claude_desktop_config.json，然后重启 Claude。
或者使用 npm 全局安装，并配置其他支持 MCP 的 AI 助手。

claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-jira"
      ],
      "env": {
        "ATLASSIAN_SITE_NAME": "your-company",
        "ATLASSIAN_USER_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}

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

.vscode/mcp.json

{
  "servers": {
    "jira": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-jira"
      ],
      "env": {
        "ATLASSIAN_SITE_NAME": "your-company",
        "ATLASSIAN_USER_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}

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

Terminal

claude mcp add jira -e ATLASSIAN_SITE_NAME=your-company -e [email protected] -e ATLASSIAN_API_TOKEN=your_api_token -- npx -y @aashari/mcp-server-atlassian-jira

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

生成并校验客户端配置

验证是否装好

配置完成后重启 Claude Desktop，在工具列表中应能看到 jira_get、jira_post 等五个 jira_ 工具；也可以用 CLI 运行 npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/myself" 验证凭据是否有效。

常见排障

认证失败或 403：检查 API 令牌是否有效、站点名称是否正确（例如 mycompany vs mycompany.atlassian.net）
资源不存在或 404：检查 API 路径是否区分大小写，使用项目键而非名称
搜索无结果：尝试更广泛的条件，或先在 Jira 高级搜索中验证 JQL
Claude Desktop 集成问题：重启 Claude，验证配置文件路径

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我有权限访问的所有 Jira 项目
查看 PROJ-123 的详细信息，包括评论
给 PROJ-456 添加评论：'代码审查已完成，可以测试了'
搜索 DEV 项目中所有进行中的高优先级问题

工具能力 5

jira_get 只读

向任何 Jira API 端点发送 GET 请求以读取数据。

jira_post 写入

向任何端点发送 POST 请求以创建资源。

jira_put 写入

向任何端点发送 PUT 请求以完全替换资源。

jira_patch 写入

向任何端点发送 PATCH 请求以部分更新资源。

jira_delete 破坏性

向任何端点发送 DELETE 请求以删除资源。

使用场景

列出所有可访问的项目

使用 JQL 搜索问题，例如“DEV 项目中进行中的高优先级问题”

获取特定问题的详情，包括评论

添加评论到问题

跨项目搜索缺陷

创建或更新问题

跟踪工作日志和状态变更

支持客户端

Claude Desktop

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

详细介绍

此 MCP 服务器为 AI 助手（如 Claude、Cursor AI）提供与 Atlassian Jira 交互的能力。它通过五个通用工具（jira_get、jira_post、jira_put、jira_patch、jira_delete）暴露 Jira REST API v3 的任意端点，支持项目列表、问题检索（JQL）、评论管理、工作日志操作等。默认使用 TOON 格式输出，可减少 30-60% 的 token 消耗，并支持 JMESPath 过滤。