Script

🚀 Jira MCP（模型控制协议）

Jira MCP是一个基于Golang的连接器，能让Claude等AI助手与Atlassian Jira进行交互。它提供了无缝接口，让AI模型可以轻松执行常见的Jira操作，提升工作效率。

✨ 主要特性

• 获取详细问题信息
• 创建、更新和搜索问题（包括子问题）
• 列出所有可用的问题类型和状态
• 添加和检索评论
• 向问题添加日志
• 列出和管理Sprint
• 检索问题历史记录和关系
• 链接问题并获取相关问题
• 通过工作流过渡问题

📦 安装指南

要求： Golang 1.20+（用于从源码构建）

有多种方式可以安装Jira MCP：

方案1：从GitHub发行版下载

1. 访问GitHub发行版页面。
2. 下载适用于您平台的二进制文件：
   • jira-mcp_linux_amd64 用于Linux
   • jira-mcp_darwin_amd64 用于macOS
   • jira-mcp_windows_amd64.exe 用于Windows
3. 对于Linux/macOS，使二进制文件可执行：

   chmod +x jira-mcp_*
   

4. 将其移动到您的PATH目录（Linux/macOS）：

   sudo mv jira-mcp_* /usr/local/bin/jira-mcp
   

方案2：使用Go安装

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

方案3：Docker

直接使用Docker

1. 从GitHub容器 registry拉取预构建的镜像：

   docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest
   

2. 或者在本地构建Docker镜像：

   docker build -t jira-mcp .
   

📚 详细文档

配置

环境变量

以下环境变量用于身份验证，这些是必需的：

ATLASSIAN_HOST=your_atlassian_host
ATLASSIAN_EMAIL=your_email
ATLASSIAN_TOKEN=your_token

您可以设置为：

1. 直接在Docker运行命令中（推荐）
2. 通过.env文件（可选，仅限本地开发，使用-env标志）
3. 直接在您的shell环境变量中

与Claude和Cursor一起使用

要使Jira MCP与Claude和Cursor配合工作，您需要将配置添加到Cursor设置中。

步骤1：安装Jira MCP

选择上述任意一种安装方法（推荐Docker）。

步骤2：配置Cursor

1. 打开Cursor。
2. 转到设置 > MCP > 添加MCP服务器。
3. 添加以下配置：

选项A：使用Docker（推荐）

{
  "mcp": {
    "servers": [
      {
        "name": "Jira Docker",
        "type": "docker",
        "command": "jira-mcp",
        "args": [
          "--host ${ATLASSIAN_HOST}",
          "--email ${ATLASSIAN_EMAIL}",
          "--token ${ATLASSIAN_TOKEN}"
        ]
      }
    ]
  }
}

选项B：使用本地二进制文件

{
  "mcp": {
    "servers": [
      {
        "name": "Jira Local",
        "type": "local-binary",
        "path": "/usr/local/bin/jira-mcp",
        "args": [
          "--host ${ATLASSIAN_HOST}",
          "--email ${ATLASSIAN_EMAIL}",
          "--token ${ATLASSIAN_TOKEN}"
        ]
      }
    ]
  }
}

步骤3：使用Claude

现在，您可以通过Claude调用Jira MCP。例如：

claude --mcp "jira" --command "search-issues" --arg "query:My Project"

贡献指南

要为项目做出贡献，请访问GitHub仓库，然后按照贡献指南进行操作。

📄 许可证

该项目遵守MIT许可证。