jira-mcp

jira-mcp 是一个用 Go 编写的 Jira MCP（Model Context Protocol）服务器，使 Claude Desktop、Cursor 等 AI 助手能够直接与 Atlassian Jira 交互。项目通过 STDIO 传输协议暴露 23 个标准化工具，覆盖 Issue 全生命周期管理（创建、查询、更新、状态流转、评论、工时记录）、Sprint 管理（列表、详情、活跃 Sprint 查询）、JQL 搜索、版本管理、Issue 关联关系操作以及开发信息追踪（关联分支、PR、提交，支持 GitHub/GitLab/Bitbucket）。

除 MCP 服务器外，项目还提供独立的 jira-cli 命令行工具，可直接在终端执行 Jira 操作并输出 JSON。安全方面，支持通过 ENABLED_TOOLS 环境变量配置工具白名单，实现只读代理等受限场景。提供 Docker（GHCR）、Homebrew、go install 及 GoReleaser 多平台二进制等多种分发方式，底层依赖 go-atlassian 客户端库与 Jira Cloud API 通信。

工具清单#

Issue 管理：jira_get_issue、jira_create_issue、jira_create_child_issue、jira_update_issue、jira_list_issue_types

搜索：jira_search_issue（JQL 搜索，支持自定义字段与 expand 选项）

Sprint 管理：jira_list_sprints、jira_get_sprint、jira_get_active_sprint、jira_search_sprint_by_name

状态与工作流：jira_list_statuses、jira_transition_issue

评论与工时：jira_add_comment、jira_get_comments、jira_add_worklog

历史与关联：jira_get_issue_history、jira_get_related_issues、jira_link_issues

版本与开发信息：jira_get_version、jira_list_project_versions、jira_get_development_information

架构要点#

• 单体 Go 二进制，内嵌 MCP 服务器 + 独立 CLI 入口
• main.go 负责 MCP 服务器初始化与工具注册
• services/jira_client.go 实现 Jira 客户端单例，处理 Email + API Token 认证
• tools/ 目录按类别组织工具，遵循统一的 registration + handler + typed input validation 模式
• 传输模式：STDIO（默认）+ HTTP（可选调试，-http_port 参数）
• 构建分发：GoReleaser 多平台构建（.goreleaser.yaml），集成 .gitleaks.toml 进行 Git 泄露检测

安装方式#

Docker：

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
        "-e", "ATLASSIAN_HOST=https://your-company.atlassian.net",
        "-e", "ATLASSIAN_EMAIL=your-email@company.com",
        "-e", "ATLASSIAN_TOKEN=your-api-token",
        "ghcr.io/nguyenvanduocit/jira-mcp:latest"]
    }
  }
}

Homebrew：brew install nguyenvanduocit/tap/jira-mcp

go install：go install github.com/nguyenvanduocit/jira-mcp/cmd/jira-cli@latest

环境变量：ATLASSIAN_HOST、ATLASSIAN_EMAIL、ATLASSIAN_TOKEN（API Token 在 Atlassian 账户安全页面创建）

CLI 示例#

jira-cli get-issue --issue-key PROJ-123
jira-cli search-issues --jql "project = PROJ AND status = 'In Progress'" --max-results 20
jira-cli create-issue --project PROJ --summary "Fix login bug" --type Bug
jira-cli transition-issue --issue-key PROJ-123 --transition-id 31

待确认信息#

• MCP 协议具体版本号未在 README 中标注
• jira_download_attachment 工具在白名单示例中出现但工具列表中未详细描述
• 是否支持 Jira Server/Data Center 本地部署实例尚不明确
• Homebrew tap 仓库实际可用性未验证