Jira Extended MCP Server

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和文档。自那以后，功能可能发生了变化。

|---|---|---|---|---| |范围|仅限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包管理器。如果你没有：

# 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
2. 点击 创建API令牌
3. 复制令牌——下一步您将需要它

步骤3：配置您的AI客户端

选择添加配置的位置：

Claude Code

最简单的命令：

# 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 全球安装。对于仅项目安装，省略它。

或者手动编辑配置文件：

在文本编辑器中打开文件：

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

# Windows
notepad %USERPROFILE%\.claude.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

在文本编辑器中打开配置文件：

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

# Windows
notepad %APPDATA%\Claude\claude_desktop_config.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 在项目根目录中：

mkdir -p .vscode
code .vscode/mcp.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

打开配置文件：

# macOS / Linux
code ~/.cursor/mcp.json

# Windows
notepad %USERPROFILE%\.cursor\mcp.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)

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项目”

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

配置

环境变量

查找您的开始日期字段ID

开始日期字段ID因Jira实例而异。使用 get_createmeta 您的项目查看可用字段的工具，或：

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会自动将它们呈现为富文本。

完整参考： Jira Wiki标记

可用工具

Issue CRUD (6 tools)

Transitions (3 tools)

Issue Links (3 tools)

Release Management (4 tools)

Sprint Management (2 tools)

Comments & Worklogs (3 tools)

Project & Metadata (6 tools)

建筑

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

关键设计决策：

发展

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团队