SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI编程工具mcp-server-atlassian-jira

mcp-server-atlassian-jira

mcp-server-atlassian-jira 是一个基于 Node.js/TypeScript 的 MCP 服务器，用于连接 Atlassian Jira Cloud。它让 Claude、Cursor AI 等支持 MCP 的 AI 助手能够直接访问 Jira 的项目、问题、评论及开发信息（提交、PR），通过自然语言完成项目查询、问题搜索、评论管理、创建与更新问题等操作。该工具在本地运行，使用用户自己的 Jira 凭据，支持 TOON 输出格式以节省 token，并支持 JMESPath 过滤。仅支持 Jira Cloud，不支持 Jira Server/Data Center。

访问官网

工具介绍

用途

mcp-server-atlassian-jira 是一个 Node.js/TypeScript 实现的 MCP（Model Context Protocol）服务器，用于将 AI 系统（LLM）与 Atlassian Jira Cloud 连接。它让 Claude、Cursor AI 等支持 MCP 的 AI 助手能够直接操作 Jira 的项目管理、问题跟踪和工作流，通过自然语言完成查询与管理任务。

主要能力

该服务器提供 5 个通用工具，可访问任意 Jira REST API v3 端点，涵盖：

  • 列出/获取项目（如 /rest/api/3/project/search、/rest/api/3/project/{projectKeyOrId}）
  • 使用 JQL 或 ID 搜索/获取问题（/rest/api/3/search/jql、/rest/api/3/issue/{issueIdOrKey}）
  • 创建问题（POST /rest/api/3/issue）
  • 获取/执行状态转换（/rest/api/3/issue/{issueIdOrKey}/transitions）
  • 列出/添加/更新/删除评论（/rest/api/3/issue/{issueIdOrKey}/comment）
  • 列出/添加/更新/删除工作日志（/rest/api/3/issue/{issueIdOrKey}/worklog）
  • 查看开发信息（提交、PR）
  • 用户与状态查询（/rest/api/3/myself、/rest/api/3/user/search、/rest/api/3/status、/rest/api/3/issuetype、/rest/api/3/priority）

默认输出采用 TOON（Token-Oriented Object Notation）格式，相比 JSON 可减少 30-60% 的 token 消耗；也可通过 --output-format json 或 outputFormat: "json" 切换为 JSON。所有工具支持可选的 JMESPath（jq）过滤以提取特定数据。对于超过 40k 字符（约 10k token）的大型响应，会自动截断并给出提示，完整原始响应保存至 /tmp/mcp/mcp-server-atlassian-jira/<timestamp>-<random>.txt。

使用方式

  1. 获取 Jira 凭据：前往 Atlassian API Tokens 创建 API token，并立即复制。
  2. 连接 AI 助手：
    • Claude Desktop 用户：在配置文件 ~/.claude/claude_desktop_config.json 中添加配置，重启 Claude Desktop 后状态栏会出现 jira 服务器。
    • 其他 AI 助手：全局安装服务器（npm 安装命令见官方仓库），然后配置 AI 助手使用 STDIO 传输的 MCP 服务器。
    • 替代方案：创建 ~/.mcp/configs.json 进行系统级配置，配置键可使用 "jira"、"atlassian-jira"、"@aashari/mcp-server-atlassian-jira" 或 "mcp-server-atlassian-jira"。
  3. CLI 直接访问：CLI 命令与 MCP 工具对应，支持 --output-format（toon 默认或 json）、--jq（JMESPath 过滤）、--query-params（JSON 字符串形式的查询参数）。

适用场景

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

限制

  • 仅支持 Jira Cloud，不支持 Jira Server/Data Center（未来版本可能添加）。
  • 需要 Node.js 18.0.0 或更高版本。
  • 需要 Atlassian 账户具备相应项目权限，API token 需有效。
  • 站点名称格式：Jira URL 为 https://mycompany.atlassian.net 时，站点名称为 mycompany。
  • 数据安全：工具完全在本地运行，使用用户自己的 Jira 凭据，不向第三方发送数据，仅访问授权范围。

技术细节

  • 版本 3.2.1（2025年12月）：新增 TOON 输出格式；实现自动响应截断；原始响应保存至 /tmp/mcp/mcp-server-atlassian-jira/；更新至 MCP SDK v1.23.0；修复已弃用的 /rest/api/3/search 端点（现使用 /rest/api/3/search/jql）；更新依赖（Zod v4.1.13、Commander v14.0.2）。
  • 架构遵循 5 层 MCP 架构：CLI 层、Tools 层、Controllers 层、Services 层、Utils 层。
  • 调试：设置 DEBUG 环境变量启用调试日志，日志写入 ~/.mcp/data/mcp-server-atlassian-jira.<session-id>.log。
  • 从 v2.x 迁移：v3.0 将 8+ 个特定工具替换为 5 个通用 HTTP 方法工具，例如 jira_ls_projects 变为 jira_get 配合 path /rest/api/3/project/search。

常见问题

  • 认证失败或 403：检查 API token 权限和有效期，验证站点名称格式，可用 npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/myself" 测试凭据。
  • 资源未找到或 404：检查 API 路径大小写，使用项目键（如 DEV）而非项目名称，问题键包含项目前缀（如 DEV-123），确认访问权限。
  • 搜索无结果：尝试不同搜索词，使用项目键，检查 JQL 语法。
  • Claude Desktop 集成问题：更新配置后重启，确认配置文件位置（macOS: ~/.claude/claude_desktop_config.json；Windows: %APPDATA%\Claude\claude_desktop_config.json）。

更多帮助可访问 GitHub 仓库 github.com/aashari/mcp-server-atlassian-jira 或提交 Issue。

同类工具

查看分类