Jira v7.10.0 MCP

当 AI 需要"链接世界"：我用 Claude Code 半小时造了一个 Jira MCP

从 OPC 说起

最近一年，AI 编程助手的能力进化有目共睹。但如果你真正在日常工作中深度使用过，会发现一个核心矛盾：

AI 很聪明，但它被困在对话框里。

它能帮你写代码、做分析、出方案，但它无法帮你查一下 Jira 上那个 Bug 修到哪了，无法帮你在项目管理系统里创建一个任务，无法帮你把需求状态从"待评审"流转到"开发中"。

这就是为什么我越来越看好 OPC（Operator-Computer）模式 —— 让 AI 不只是"对话伙伴"，而是真正的"操作者"，能够通过标准化协议去触达和操作各种外部系统。

而 MCP（Model Context Protocol），正是实现这一切的桥梁。

一个现实问题：老版本 Jira 怎么办？

我们公司用 Jira 做需求管理，版本是 v7.10.0 —— 一个相当"古早"的版本。

当我决定给 Claude Code 接入 Jira 能力时，第一反应是去 MCP Store 找现成的。结果发现：

有不少 Jira MCP，但大多面向 Jira Cloud 或较新的 Data Center 版本

老版本 Jira Server 的 API 行为和新版有差异，兼容性是个问号

与其花时间逐个验证，不如自己造一个 —— 反正有 Claude Code

于是，一个下午的时间，jira-mcp 就诞生了。

它能做什么？

jira-mcp 将 Jira 的核心操作封装为 18 个 MCP 工具，覆盖了日常项目管理的主要场景：

问题管理 —— 搜索、查看、创建、更新问题，执行工作流状态转换

评论协作 —— 查看和添加问题评论

项目信息 —— 查看项目列表、组件、版本（发布）信息

元数据查询 —— 查询字段定义、问题类型、优先级、状态、解决方案等

注册到 Claude Code 之后，你可以用自然语言完成这些操作：

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

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

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

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

不需要打开浏览器，不需要在 Jira 界面里点来点去。对话即操作。

技术实现：极简但够用

整个项目的代码结构非常精简：

jira-mcp/

├── pyproject.toml              # 项目元数据与依赖

├── install.sh                  # 安装脚本

└── src/

    └── jira_mcp/

        ├── __main__.py         # 入口

        ├── server.py           # MCP 服务端 & 工具定义

        └── jira_client.py      # Jira REST API v2 异步客户端

几个关键技术选型：

Jira API

：REST API v2（/rest/api/2/），Jira Server v7.10.0 完全支持

认证方式

：HTTP Basic Auth（此版本只支持基于账号密码的认证方式）

HTTP 客户端

：httpx（异步），请求超时 30 秒

MCP SDK

：Anthropic 官方的 mcp[cli]

传输协议

：stdio

没有复杂的架构，没有多余的抽象。一个异步 HTTP 客户端负责和 Jira 通信，一个 MCP 服务端负责把能力暴露给 AI —— 就这么简单。

如何使用

前置条件

Python 3.10+

Jira Server 实例及有效的账号凭证

Claude Code

安装

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

cd jira-mcp

./install.sh

配置三个环境变量

变量

说明

JIRA_BASE_URL

Jira Server 地址

JIRA_USERNAME

Jira 账号用户名

JIRA_PASSWORD

Jira 账号密码

注册到 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

注册完成，即刻可用。

一些思考

做这个 MCP 的过程本身，就是 OPC 模式的一次实践：我提出需求和约束（Jira v7.10.0、REST API v2、需要哪些能力），Claude Code 负责实现。整个过程非常流畅。

但更重要的是它带来的后续价值 —— 从此以后，我和 AI 协作处理需求管理工作时，不再需要在 Jira 界面和对话框之间反复切换。AI 真正成为了工作流的一部分，而不只是一个"顾问"。

这也是 OPC 模式的核心理念：不是让 AI 告诉你怎么做，而是让 AI 帮你做。

要实现这一点，就需要越来越多的 MCP 来"链接世界"。Jira 只是第一步。

项目已开源，GitHub 地址：https://github.com/zhouqia/jira-mcp

如果你的团队也在用老版本 Jira，或者对 OPC 模式和 MCP 生态感兴趣，欢迎交流。

上一条：jira系统怎么用

下一条：AI+Jira：自动分析Bug模式、预测高风险模块