用途
jira-mcp 是一个基于 Go 的 MCP（Model Control Protocol）连接器，用于让 Claude 等 AI 助手与 Atlassian Jira 交互。它面向实际软件开发工作流，帮助 AI 模型执行常见的 Jira 操作，如问题管理、冲刺规划和工作流转换。项目定位为“有主见的”Jira MCP 服务器，源自多年真实软件开发经验以及工程师和自动化 QC 团队的日常工作流程。
主要能力
工具按类别组织，默认全部注册：
- 问题管理：jira_get_issue（获取问题详情，含状态、负责人、描述、子任务及可用转换）、jira_create_issue（创建问题，返回 key、ID、URL）、jira_create_child_issue（创建子任务并关联父问题）、jira_update_issue（修改问题，支持部分更新）、jira_list_issue_types（列出项目中的问题类型）、jira_search_issue（使用 JQL 搜索问题，支持自定义字段和展开选项）。
- 冲刺管理：jira_list_sprints（列出指定看板或项目的活动及未来冲刺）、jira_get_sprint（按 ID 获取冲刺详情）、jira_get_active_sprint（获取当前活动冲刺）、jira_search_sprint_by_name（按名称精确或部分匹配搜索冲刺）。
- 状态与转换：jira_list_statuses（获取项目的问题状态 ID 与名称）、jira_transition_issue（使用有效转换 ID 推进工作流）、jira_add_comment（添加评论，使用 Atlassian Document Format）、jira_get_comments（获取问题所有评论）、jira_add_worklog（添加工时记录）。
- 历史与审计：jira_get_issue_history（获取问题的完整变更历史）。
- 问题关系：jira_get_related_issues（获取有关联的问题，如 blocks、is blocked by、relates to 等）、jira_link_issues（创建两个问题之间的关联并定义关系）。
- 版本管理：jira_get_version（获取指定项目版本详情）、jira_list_project_versions（列出项目所有版本）。
- 开发信息：jira_get_development_information（通过 GitHub、GitLab、Bitbucket 等开发工具集成，获取关联到问题的分支、拉取请求和提交）。
使用方式
- 获取 API token：在 https://id.atlassian.com/manage-profile/security/api-tokens 创建。
- 添加到 Cursor：使用 Docker 或本地二进制（STDIO 模式，无需端口）。
- 在 Cursor 中试用，例如：“Show my issues assigned to me”“What's in the current sprint for ABC?”“Create a bug in ABC: Login fails on Safari”。
所需环境变量：
- ATLASSIAN_HOST：https://your-company.atlassian.net
- ATLASSIAN_EMAIL：你的 Atlassian 邮箱
- ATLASSIAN_TOKEN：API token
本地运行时可选使用 .env。还支持 HTTP 模式（可选，用于调试）。
项目另附带独立的 CLI 二进制 jira-cli，可直接在终端使用，无需 MCP 客户端。每个命令均支持：
- --env string：.env 文件路径
- --output string：输出格式，text（默认）或 json
通过 ENABLED_TOOLS 限制暴露的工具：默认注册全部 Jira 工具；如需只暴露子集（例如给 AI 代理一个只读的 Jira 视图），可将 ENABLED_TOOLS 环境变量设为逗号分隔的工具名允许列表。未设置或为空时暴露全部工具（向后兼容）；名称周围空白会被容忍；未知名称会被忽略但在启动时记录日志，便于发现拼写错误；未列出的名称不会被注册，因此 MCP 客户端不会看到。例如只读代理示例可暴露 15 个读取工具，阻止全部 8 个变更工具。
安装方式包括 Homebrew（macOS/Linux）。
适用场景
适用于需要让 AI 助手参与 Jira 日常操作的团队，例如管理冲刺、追踪开发工作、协调发布、维持团队间的可见性。工具设计针对现代软件开发中出现的实际问题，如获取问题关联的所有拉取请求、管理复杂的冲刺转换等。
限制
- 需要 Atlassian API token 及相应账号配置。
- 使用 Jira 操作受制于所配置账号的权限。
- ENABLED_TOOLS 未列出的工具不会被注册，MCP 客户端不可见。
- 具体收费信息、价格、平台支持完整性等暂未提供。
技术说明
- 基于 Go 的 MCP 服务器，每个工具遵循注册 + 处理程序模式，并带类型化输入验证。
- 工具按类别组织（issues、sprints、comments、worklogs 等）。
- 所有 Jira 操作使用 github.com/ctreminiom/go-atlassian 客户端库。
- 项目结构参考 CLAUDE.md、main.go、services/jira_client.go、tools/、docs/ 等文件。
- 许可证：MIT（见 LICENSE）。
