AI导哈

Jira开发工具

Jira MCP是一个面向开发者的模型上下文协议服务器，通过标准输入输出与Jira工具进行通信。

  • by xerenahmed
  • Rust
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 xerenahmed/jira-mcp

使用说明

Jira MCP

关于

用于Jira的以开发人员为中心的模型上下文协议（MCP）服务器，通过stdio进行通信。

  • 板条箱：
    • crates/jira-mcp：MCP服务器公开Jira工具
    • crates/jira-client：Jira REST客户端
  • 31工具 7个类别（见下文）

可用工具

问题管理

工具 说明
create_issue 创建Jira问题
update_issue 更新问题字段
get_issue 获取完整字段、名称映射和模式的问题
search_issues 按JQL查询搜索
assign_issue 分配/取消分配用户
get_transitions 获取可用的状态转换
transition_issue 向新状态过渡

评论

工具 说明
add_comment 添加注释（支持可见性限制）
get_comments 获取评论（按创建顺序排列）
update_comment 更新现有评论
delete_comment 删除评论

标签

工具 说明
list_labels 列出/搜索标签（使用 query 200多个标签）
add_label 添加标签（接受数组）
remove_label 删除标签（接受数组）

守望者

工具 说明
get_watchers 获取所有观察者
add_watcher 添加观察者
remove_watcher 删除观察者

问题链接

工具 说明
list_link_types 列出可用的链接类型（块、重复项等）
link_issues 在问题之间建立联系
delete_issue_link 删除问题链接

Sprint管理

工具 说明
list_sprints 列出板上的冲刺
get_sprint 获取冲刺详细信息
move_to_sprint 将问题转移到sprint
move_to_backlog 将问题移至待办事项列表

元数据和用户

工具 说明
list_projects 列出可访问的项目
list_boards 项目列表板
list_issue_types 列出问题类型
list_fields 列出项目/问题类型的字段
get_field_details 获取字段架构和允许的值
get_user_info 获取当前用户信息
search_users 按姓名/电子邮件搜索用户

安装

预构建版本

从以下网址下载适用于您平台的最新二进制文件 GitHub发布:

平台 存档
Linux x86_64 jira-mcp-linux-x86_64.tar.gz
macOS x86_64（英特尔） jira-mcp-macos-x86_64.tar.gz
macOS ARM64（苹果硅） jira-mcp-macos-arm64.tar.gz 
# Example: Download and extract (Linux/macOS)
curl -L -o jira-mcp.tar.gz https://github.com/xerenahmed/jira-mcp/releases/latest/download/jira-mcp-macos-arm64.tar.gz
tar -xzf jira-mcp.tar.gz
./jira-mcp --help

macOS用户注意事项： 如果您在首次运行二进制文件时看到安全警告（“Apple无法验证…”），则可以删除隔离属性：

xattr -d com.apple.quarantine ./jira-mcp

或前往 系统设置>隐私和安全>安全 然后单击 “无论如何都允许” 在尝试运行二进制文件之后。

从源头构建

需要Rust（稳定）。repo通过以下方式固定版本 rust-toolchain.toml.

cargo build --release

二进制文件将位于 target/release/jira-mcp.

配置

服务器需要三个参数，通过CLI参数或环境变量提供：

参数 CLI标志 环境变量 说明
Jira URL --jira-url JIRA_BASE_URL 您的Jira实例URL（例如。， https://your-domain.atlassian.net)
用户名 --username JIRA_USERNAME 您的Jira用户名/电子邮件
API代币 --token JIRA_TOKEN 你的 Jira API代币

CLI参数优先于环境变量。

直接运行

# With CLI arguments
./jira-mcp \
  --jira-url https://your-domain.atlassian.net \
  --username you@example.com \
  --token your-api-token

# With environment variables
JIRA_BASE_URL=https://your-domain.atlassian.net \
JIRA_USERNAME=you@example.com \
JIRA_TOKEN=your-api-token \
./jira-mcp

添加到克劳德

选项1：使用Claude CLI（推荐）

# Add to Claude using the CLI command
claude mcp add jira \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -e JIRA_USERNAME=you@example.com \
  -e JIRA_TOKEN=your-api-token \
  -- /path/to/jira-mcp

选项2：手动配置

在以下位置更新您的Claude配置 ~/.claude.json:

{
  "mcpServers": {
    "jira": {
      "command": "/path/to/jira-mcp",
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "you@example.com",
        "JIRA_TOKEN": "your-api-token"
      }
    }
  }
}

重新启动Claude以加载服务器。

与Claude一起使用Jira MCP

安装后，您可以直接与Jira交互：

  • “在ENG项目中创建新任务”
  • “搜索分配给我的所有打开的Bug”
  • “用评论更新PROJ-123问题”
  • “列出我们项目中可用的所有字段”

贡献

  • 格式： cargo fmt --all
  • 棉绒： cargo clippy --workspace --all-targets -D warnings

相关 MCP