Jira Extended MCP Server

MCPAI代理

提供方 Juhwan01

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

Jira Extended MCP Server是一款专注于Jira Cloud集成的轻量级MCP服务器,支持批量操作、丰富的文本编辑、冲刺和发布管理等功能,适用于AI代理和开发团队。

一句话选型结论

按资料字段整理

Jira Extended MCP Server 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 27 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量27暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Jira集成Python本地部署批量操作项目管理AI代理轻量级

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
python -m jira_extended_mcp.server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 27 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 27 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Jira Extended MCP Server当前 27 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Juhwan01上游标注的维护方 Juhwan01
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.9 KB
来自项目仓库与上游目录的原文,未做删改

Jira Extended MCP Server

Full-featured Jira Cloud integration for AI agents

27 tools · Bulk ops · Rich text · Sprints · Releases · Issue links

Quick Start ·
Use Cases ·
Tools ·
Configuration

한국어 | English


> 建造于 Moobean团队 --一个轻量级的、仅支持Jira的MCP服务器,专注于用最少的设置完成任务。

是什么让这与众不同

  • 只有Jira,零膨胀 --没有汇流,没有额外的模块。一 uvx 命令,你就可以跑了。
  • Wiki标记支持 -使用Jira REST API v2,因此 *bold*, h2. Title, * bullet 只需工作。没有ADF JSON的麻烦。
  • 批量操作 --在一次通话中创建多达50个问题或转换多个问题。
  • 完整的发布生命周期 --创建、更新、删除版本并将问题分配给版本。
  • 问题链接 --阻止、关联、复制、克隆——支持创建、查询和删除。

比较

> 注: 功能数据基于截至2026年3月的每个项目的README和文档。自那以后,功能可能发生了变化。

吉拉mcp · mcp澳大利亚 · Atlassian Rovo MCP · Jira扩展
范围 · 仅限Jira · Jira+汇流 · Jira+汇流+指南针 · 仅限Jira
发出CRUD · 只读 · 完整CRUD · 完整CRUD
批量创建 · 支持 · 支持 · 50个问题/电话
批量过渡 · 支持
父/子任务 · 支持 · 支持 · 受支持
fixVersions · 支持 · 支持 · 受支持
startDate/dueDate · 支持 · 支持 · 受支持
问题链接 · 支持 · 受支持
发布管理 · 4工具
Sprint管理 · 支持 · 受支持
富格文本 · Markdown→ ADF · ADF · Wiki标记(v2 API)
设置 · npm · pip/Docker · OAuth(云托管) · uvx 俏皮话
Jira工具总数 · 2 · ~30(Jira部分) · ~25(Jira的部分) · 27
语言 · TypeScript · Python · 远程(SaaS) · Python

用例

用自然语言问你的AI代理:

问题管理

> 在KAN项目中创建一个名为“用户认证系统”的史诗,开始日期为4月1日,到期日期为4年30日

> “在KAN-42下创建5个故事:登录、注册、密码重置、社交登录、2FA”

> “显示KAN项目中的所有‘进行中’问题”

批量操作

> “将本次冲刺中的所有10个积压问题转换为‘完成’”

> “显示v2.0版本中包含的问题列表”

释放与精神

> “在KAN项目中创建v2.1.0版本,发布日期为5月15日”

> “将KAN-50和KAN-51移动到当前的主动冲刺”

问题链接

> “将KAN-10链接为阻止KAN-20”

富文本(Wiki标记)

> “在描述中使用h2标题和项目符号列表创建问题”

快速开始

先决条件

  • uv (Python包管理器——如果需要,会自动安装Python)
  • Jira API代币

第一步:安装uv

uv 是一个Python包管理器。如果你没有:```bash

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"


### 步骤2:获取Jira API代币

1. 首选https://id.atlassian.com/manage-profile/security/api-tokens
1. 点击 **创建API令牌**
1. 复制令牌——下一步您将需要它

### 步骤3:配置您的AI客户端

选择添加配置的位置:

|范围|文件|效果|
|---|---|---|
| **全球** (推荐)| `~/.claude.json` |适用于所有项目|
| **仅限项目** | `.mcp.json` 在项目根目录中|仅在该项目中|

Claude Code

**最简单的命令:**```bash
# macOS / Linux
claude mcp add jira-extended -s user \
-e JIRA_URL=https://your-instance.atlassian.net \
-e JIRA_EMAIL=your-email@example.com \
-e JIRA_API_TOKEN=your-token \
-- uvx jira-extended-mcp

# Windows — use uvx.exe (not uvx) to avoid .cmd wrapper issues
claude mcp add jira-extended -s user \
-e JIRA_URL=https://your-instance.atlassian.net \
-e JIRA_EMAIL=your-email@example.com \
-e JIRA_API_TOKEN=your-token \
-- uvx.exe jira-extended-mcp

> -s user 全球安装。对于仅项目安装,省略它。

或者手动编辑配置文件:

在文本编辑器中打开文件:```bash

macOS / Linux

code ~/.claude.json # or: nano ~/.claude.json

Windows

notepad %USERPROFILE%.claude.json


添加此内容(如果文件不存在,则创建该文件):```json
{
"mcpServers": {
"jira-extended": {
"command": "uvx",
"args": ["jira-extended-mcp"],
"env": {
"JIRA_URL": "https://your-instance.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}

> Windows用户: 使用 "command": "uvx.exe" 而不是 "command": "uvx"The uvx.cmd Windows上的包装器会中断MCP stdio传输。

Claude Desktop

在文本编辑器中打开配置文件:```bash

macOS

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

notepad %APPDATA%\Claude\claude_desktop_config.json


添加或合并到文件中:```json
{
"mcpServers": {
"jira-extended": {
"command": "uvx",
"args": ["jira-extended-mcp"],
"env": {
"JIRA_URL": "https://your-instance.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}

> 如果文件已经有其他MCP服务器,请添加 "jira-extended": {...} 现有内部的块 "mcpServers" 对象。
>
> Windows用户: 使用 "command": "uvx.exe" 而不是 "command": "uvx".

VS Code (GitHub Copilot)

创建 .vscode/mcp.json 在项目根目录中:```bash
mkdir -p .vscode
code .vscode/mcp.json
``````json
{
"servers": {
"jira-extended": {
"command": "uvx",
"args": ["jira-extended-mcp"],
"env": {
"JIRA_URL": "https://your-instance.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}


> 启用MCP: **设置>聊天>MCP** 必须检查。在代理模式下工作。
>
> **Windows用户:** 使用 `"command": "uvx.exe"` 而不是 `"command": "uvx"`.

Cursor

打开配置文件:```bash
# macOS / Linux
code ~/.cursor/mcp.json

# Windows
notepad %USERPROFILE%\.cursor\mcp.json
``````json
{
"mcpServers": {
"jira-extended": {
"command": "uvx",
"args": ["jira-extended-mcp"],
"env": {
"JIRA_URL": "https://your-instance.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}

> Windows用户: 使用 "command": "uvx.exe" 而不是 "command": "uvx".

From source (development)```bash
git clone https://github.com/moobean-team/jira-extended-mcp-server.git
cd jira-extended-mcp-server
uv pip install -e .


然后使用 `"command": "jira-extended-mcp"` 而不是 `"command": "uvx"` 在您的配置中。

### 步骤4:重新启动并验证

重启你的AI客户端,然后问:

> “显示我的Jira项目”

如果你看到你的项目列表,你就准备好了。

## 配置

### 环境变量

|变量|必填|默认|描述|
|---|---|---|---|
| `JIRA_URL` |是|--|Jira Cloud实例URL|
| `JIRA_EMAIL` |是|--| Atlassian帐户电子邮件|
| `JIRA_API_TOKEN` |是|--| API令牌 |
| `JIRA_START_DATE_FIELD` |没有| `customfield_10015` |开始日期的自定义字段ID|

### 查找您的开始日期字段ID

开始日期字段ID因Jira实例而异。使用 `get_createmeta` 您的项目查看可用字段的工具,或:```bash
curl -s -u email:token https://your-instance.atlassian.net/rest/api/2/field \
| python -m json.tool | grep -i "start"

富文本(Wiki标记)

此服务器使用Jira REST API v2,它接受 Jira wiki标记 用于描述和注释字段的字符串。Jira会自动将它们呈现为富文本。

语法 · 呈现为
*bold* · 大胆
_italic_ · 斜体
h2. Section Title · H2航向
* item 1\n* item 2 · 项目符号列表
# item 1\n# item 2 · 编号列表
{code}print("hi"){code} · 代码块
[Link Text\ · https://url] · 超链接
\ · col1\ · col2\ · \n\ · a\ · b\ · · 表格

完整参考: Jira Wiki标记

可用工具

Issue CRUD (6 tools)

工具 说明
create_issue 使用完整的字段支持创建问题——父字段、fixVersions、startDate、dueDate、故事点、组件、自定义字段
create_issues_bulk 在单个API调用中批量创建多达50个问题
get_issue 使用格式化输出获取问题详细信息
update_issue 更新任何问题字段(仅发送更改的字段)
delete_issue 删除子任务处理问题
search_issues 带分页和可配置字段的JQL搜索

Transitions (3 tools)

工具 说明
get_transitions 列出问题的可用状态转换
transition_issue 按名称或ID更改问题状态,并可选择注释
bulk_transition 同时过渡多个问题

Issue Links (3 tools)

工具 说明
link_issues 在问题(块、关联、重复、克隆)之间创建链接
get_issue_links 获取包含链接类型详细信息的问题的所有链接
delete_issue_link 按ID删除链接

Release Management (4 tools)

工具 说明
get_versions 列出项目版本/发布
create_version 创建具有开始/发布日期的新版本
update_version 更新发布详细信息,标记为已发布/已存档
delete_version 删除带有问题重新分配选项的版本

Sprint Management (2 tools)

工具 说明
get_sprints 列出板的冲刺(按活动/未来/关闭筛选)
move_to_sprint 将问题转移到目标冲刺

Comments & Worklogs (3 tools)

工具 说明
add_comment 向问题添加评论(支持wiki标记)
get_comments 获取包含作者和时间戳的问题注释
add_worklog 以人性化格式记录工作时间(“2小时30分钟”、“1天”)

Project & Metadata (6 tools)

工具 说明
get_projects 列出所有可访问的项目
get_project 获取项目详细信息
get_boards 列表板(scrum/看板/简单)
get_current_user 获取经过身份验证的用户信息
search_users 按姓名/电子邮件搜索用户
get_createmeta 获取每个项目的可用问题类型和字段

建筑```

src/jira_extended_mcp/
├── server.py # FastMCP server + 27 tool definitions
├── client.py # Async Jira REST client (httpx + rate limit retry)
├── adf.py # ADF fallback helpers (v3 response parsing)
└── init.py


**关键设计决策:**

|决定|为什么|
|---|---|
| **REST API v2** 对于问题/评论|v2接受富文本的wiki标记字符串。v3需要ADF JSON,可以剥离格式|
| **REST API v3** 对于元数据|版本、项目、用户没有文本字段——v3很好|
| **敏捷API** 对于冲刺/板|冲刺操作只能通过 `/rest/agile/1.0/` |
| **快速MCP寿命** | `httpx.AsyncClient` 跨工具调用汇集,而不是按请求汇集|
| **结构化错误** |错误返回 `{error, status}` 这样法学硕士才能得到可操作的反馈|
| **可配置的开始日期字段** | `JIRA_START_DATE_FIELD` env-var处理特定于实例的自定义字段ID|

## 发展```bash
git clone https://github.com/moobean-team/jira-extended-mcp-server.git
cd jira-extended-mcp-server
uv pip install -e .

# Run directly
jira-extended-mcp

# Or via module
python -m jira_extended_mcp.server

故障排除

"Missing required env vars"

确保 JIRA_URL, JIRA_EMAIL,以及 JIRA_API_TOKEN 在MCP配置中设置 env 块。服务器在启动时检查这些。

"Transition not found"

Jira转换是特定于工作流的。使用 get_transitions 首先查看问题当前状态的可用转换。转换名称不区分大小写。

Start date not saving

您的Jira实例可能使用不同的自定义字段ID。使用 get_createmeta 要找到正确的字段,请设置 JIRA_START_DATE_FIELD 有人是。

Rate limited (429)

服务器使用自动重试最多3次 Retry-After 头球对于有50多个问题的批量操作,考虑拆分为多个调用。

Description shows as plain text

此服务器使用Jira REST API v2,它接受wiki标记。使用Jira wiki语法(*bold*, h2. Title, * bullet)而不是Markdown。

许可证

麻省理工学院 ©Moobean团队

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Jira Extended MCP Server 怎么安装?

在客户端按下面的安装命令接入:python -m jira_extended_mcp.server。装完在客户端配置里引用同一个包或端点。

Jira Extended MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Jira Extended MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Jira Extended MCP Server 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Jira Extended MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Jira Extended MCP Server 能提供哪些能力?

资料显示约 27 个工具;能力标签包括 Jira集成、批量操作、Python、Claude、轻量级。具体工具清单以官方文档为准。

Jira Extended MCP Server 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Jira Extended MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。