STARWARCLOUD STARWAR.AI
返回市场
杰拉-MCP

杰拉-MCP

作者：nguyenvanduocit69 星标更新：2025-11-10
安装使用来源：spider==github.com

项目介绍

Jira MCP

一款基于多年实际软件开发经验构建的意见型Jira MCP服务器。

与通用的Jira集成不同，此MCP是根据工程师和自动化QC团队的日常流程精心打造的。你会发现一些针对实际开发需求设计的高级工具——例如检索与某个问题相关的所有拉取请求、管理复杂的冲刺过渡或在整个工作流中跟踪开发信息。

这不仅仅是一个API封装器。它是专业人士如何使用Jira的反映：管理冲刺、跟踪开发工作、协调发布并确保团队之间的可见性。每个工具都是为了解决现代软件开发中出现的实际问题而设计的。

可用工具

问题管理

  • jira_get_issue - 获取特定问题的详细信息，包括状态、负责人、描述、子任务及可用的转换选项
  • jira_create_issue - 创建一个新问题，并指定详细信息（返回键、ID和URL）
  • jjira_create_child_issue - 创建一个子问题（子任务），并将其链接到父问题
  • jira_update_issue - 修改现有问题的详细信息（支持部分更新）
  • jira_list_issue_types - 列出项目中所有可用的问题类型及其ID、名称和描述

搜索

  • jira_search_issue - 使用JQL（Jira查询语言）搜索问题，可自定义字段和扩展选项

冲刺管理

  • 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文档格式）
  • 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 - 获取与问题关联的分支、拉取请求和提交记录（通过开发工具集成，如GitHub、GitLab、Bitbucket）

安装

将以下提示复制到您的AI助手：

安装Jira MCP服务器（https://github.com/nguyenvanduocit/jira-mcp）到我的Claude桌面或Cursor IDE。仔细阅读MCP文档，并逐步引导我完成安装。

如果您的AI助手无法帮助您完成此安装，则表明可能存在配置错误或AI工具无效。一个功能强大的AI助手应该能够指导您完成MCP的安装。

许可证

MIT — 查看LICENSE文件。

仅限AI

此部分仅供AI使用

在处理此代码库时，请阅读以下文件以了解项目结构：

  1. CLAUDE.md - 包含架构、开发命令和编码规范在内的全面项目文档
  2. main.go - 入口点，展示了MCP服务器是如何初始化和注册工具的
  3. services/jira_client.go - 单例Jira客户端初始化和认证
  4. tools/ - 遵循一致模式的各个工具实现
  5. docs/ - 详细的文档（参见结构）

关键概念：

  • 这是一个连接AI助手到Jira的Go语言MCP服务器
  • 每个工具遵循注册+处理器模式，并带有类型化的输入验证
  • 工具按类别组织（问题、冲刺、评论、工作日志等）
  • 所有Jira操作均使用github.com/ctreminiom/go-atlassian客户端库
  • 开发原则记录在.specify/memory/constitution.md中

在进行更改之前，请查阅：

  • CLAUDE.md 以了解架构模式和开发命令
  • .specify/memory/constitution.md 以了解治理原则

快速开始

1) 获取API令牌

在https://id.atlassian.com/manage-profile/security/api-tokens创建一个。

2) 添加到Cursor

使用Docker或本地二进制文件（STDIO；无需端口）。

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"
      ]
    }
  }
}

二进制

{
  "mcpServers": {
    "jira": {
      "command": "/usr/local/bin/jira-mcp",
      "env": {
        "ATLASSIAN_HOST": "https://your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@company.com",
        "ATLASSIAN_TOKEN": "your-api-token"
      }
    }
  }
}

3) 在Cursor中尝试

  • “显示分配给我的问题”
  • “ABC当前冲刺的内容是什么？”
  • “在ABC中创建一个登录失败的bug”

配置

  • ATLASSIAN_HOST: https://your-company.atlassian.net
  • ATLASSIAN_EMAIL: 您的Atlassian邮箱
  • ATLASSIAN_TOKEN: API令牌

可选的.env（如果本地运行）：

ATLASSIAN_HOST=https://your-company.atlassian.net
ATLASSIAN_EMAIL=your-email@company.com
ATLASSIAN_TOKEN=your-api-token

HTTP模式（可选，用于调试）：

jira-mcp -env .env -http_port 3000

Cursor配置（HTTP模式）：

{ "mcpServers": { "jira": { "url": "http://localhost:3000/mcp" } } }