Jira V7.10.0 Mcp

Jira MCP Server

基于 Model Context Protocol (MCP) 的 Jira Server 集成服务，让 Claude 等 AI 助手能够直接与 Jira 交互，完成项目管理和问题跟踪操作。

背景

在 OPC（Operator-Computer）协作模式下，MCP 是 AI 助手"链接世界"的关键基础设施。无论是企业协作还是个人效率提升，都需要构建和使用大量的 MCP 来打通各类工具。

Jira 作为广泛使用的需求和项目管理工具，自然是 MCP 生态中不可或缺的一环。然而，MCP Store 中现有的 Jira MCP 大多面向较新的 Jira 版本（Cloud / Data Center 8.x+），对于仍在使用老版本 Jira Server 的团队，兼容性难以保证。

本项目专为 Jira Server v7.10.0 构建，基于稳定的 REST API v2 接口。如果你的团队也在使用较早版本的 Jira Server，希望这个工具恰好是你需要的。

功能列表

问题管理

• search_issues — 使用 JQL（Jira Query Language）搜索问题
• get_issue — 获取单个问题的详细信息
• create_issue — 创建新问题（支持设置类型、优先级、指派人、标签等）
• update_issue — 更新已有问题的字段
• transition_issue — 通过工作流转换变更问题状态
• get_transitions — 获取问题可用的工作流转换列表

评论

• get_comments — 获取问题的所有评论
• add_comment — 为问题添加评论

项目

• list_projects — 列出当前用户可访问的所有项目
• get_project_components — 获取项目的所有组件
• get_project_versions — 获取项目的所有版本（发布）
• get_version — 获取特定版本的详细信息

元数据

• list_fields — 列出所有字段（含自定义字段），用于构建 JQL 查询
• list_issue_types — 列出所有问题类型（Bug、Task、Story、Epic 等）
• list_priorities — 列出所有优先级级别
• list_statuses — 列出所有问题状态
• list_resolutions — 列出所有解决方案类型（Fixed、Won't Fix 等）
• get_server_info — 获取 Jira 服务器版本及部署信息

前置条件

• Python 3.10+
• Jira Server 实例（已在 v7.10.0 上测试）及有效的账号凭证
• Claude Code（用于注册 MCP 服务）

安装

使用安装脚本

git clone https://github.com/zhouqia/jira-mcp.git
cd jira-mcp

# 先编辑 install.sh，填入你的 Jira 凭证
vim install.sh

bash install.sh

手动安装

git clone https://github.com/zhouqia/jira-mcp.git
cd jira-mcp
pip install -e .

配置

服务启动需要以下三个环境变量：

变量	说明	示例
JIRA_BASE_URL	Jira Server 地址	https://jira.example.com
JIRA_USERNAME	Jira 账号用户名	your_username
JIRA_PASSWORD	Jira 账号密码	your_password

认证方式为 HTTP Basic Auth（此版本只支持基于账号密码的认证方式），基于 Jira REST API v2。

使用

注册到 Claude Code

claude mcp add --scope user jira \
  -e JIRA_BASE_URL="https://jira.example.com" \
  -e JIRA_USERNAME="your_username" \
  -e JIRA_PASSWORD="your_password" \
  -- python -m jira_mcp

注册完成后，即可在 Claude Code 对话中直接使用所有 Jira 工具。

独立运行（用于测试）

JIRA_BASE_URL="https://jira.example.com" \
JIRA_USERNAME="your_username" \
JIRA_PASSWORD="your_password" \
python -m jira_mcp

服务通过 stdio 协议与 MCP 客户端通信。

使用示例

注册后，你可以在 Claude Code 中用自然语言与 Jira 交互：

> 搜索 MYPROJ 项目中所有未关闭的 Bug

> 在 MYPROJ 项目创建一个任务："更新 API 文档"，指派给 zhangsan，优先级设为 High

> MYPROJ-123 目前是什么状态？帮我加一条评论："已在预发布环境验证通过"

> 查看最近 7 天内我被指派的、状态发生变更的问题

> 列出 MYPROJ 项目的所有版本

项目结构

jira-mcp/
├── README.md
├── pyproject.toml              # 项目元数据与依赖声明
├── install.sh                  # 自动化安装脚本
└── src/
    └── jira_mcp/
        ├── __init__.py
        ├── __main__.py         # 入口（python -m jira_mcp）
        ├── server.py           # MCP 服务端 & 工具定义
        └── jira_client.py      # Jira REST API v2 异步客户端

技术细节

• Jira API: REST API v2（/rest/api/2/）
• 传输协议: stdio（标准输入/输出）
• HTTP 客户端: httpx（异步）
• MCP SDK: mcp[cli]（Anthropic 官方 SDK）
• 请求超时: 30 秒

许可证

MIT