Jira MCP

Jira MCP

site icon
2025.04.17 7
GoJira 连接器AI 助手集成交流协作
Jira MCP 是一个基于 Go 语言的 MCP(Model Control Protocol)连接器,专为 Atlassian Jira 设计。它使 AI 助手(如 Claude)能够与 Jira 进行交互,执行常见的 Jira 操作。该工具提供了无缝的接口,支持获取问题详情、搜索问题、管理冲刺、创建和更新问题等核心功能。
View on GitHub

Overview

基本能力

产品定位

Jira MCP 是一个连接 AI 助手与 Jira 项目的桥梁,旨在通过 MCP 协议实现 AI 与 Jira 的无缝交互。

核心功能

  • 获取问题详情
  • 使用 JQL 搜索问题
  • 列出和管理冲刺
  • 创建和更新问题
  • 列出可用状态
  • 通过工作流转换问题状态

适用场景

  • AI 助手需要与 Jira 项目进行交互的场景
  • 自动化 Jira 任务管理
  • 通过 AI 查询和更新 Jira 问题

工具列表

  • jira-mcp:主程序,提供与 Jira 交互的所有功能

常见问题解答

  • 安装问题:确保下载正确的平台二进制文件并设置正确的权限
  • 配置问题:确保 .env 文件中的环境变量正确设置

使用教程

使用依赖

  • Go 环境(如果选择从源码安装)

安装教程

选项1:从 GitHub Releases 下载

  1. 访问 GitHub Releases 页面
  2. 下载适合您平台的二进制文件:
  3. jira-mcp_linux_amd64 用于 Linux
  4. jira-mcp_darwin_amd64 用于 macOS
  5. jira-mcp_windows_amd64.exe 用于 Windows
  6. 使二进制文件可执行(Linux/macOS): bash chmod +x jira-mcp_*
  7. 将其移动到 PATH 中(Linux/macOS): bash sudo mv jira-mcp_* /usr/local/bin/jira-mcp

选项2:Go install

go install github.com/nguyenvanduocit/jira-mcp

配置

环境

  1. .env 文件中设置环境变量: ATLASSIAN_HOST=your_atlassian_host ATLASSIAN_EMAIL=your_email ATLASSIAN_TOKEN=your_token
  2. 构建并运行工具

Claude, cursor 配置

{
  "mcpServers": {
    "jira": {
      "command": "/path-to/jira-mcp",
      "args": ["-env", "path-to-env-file"]
    }
  }
}

调试方式

  • 确保环境变量正确设置
  • 检查二进制文件是否可执行
  • 验证 Jira API 访问权限

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。