快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

python3 -m venv .venv

详细介绍

Jira票证管理CLI

使用Jira Cloud REST API查看、搜索和状态切换我的票证的简单CLI工具。

设置

创建虚拟环境并安装依赖性 （推荐）

在MacOS等系统中，如果系统Python是PEP668（externally-managed-environment），则使用虚拟环境是安全的。

   cd ~/jira-helper
   python3 -m venv .venv
   source .venv/bin/activate   # Windows: .venv\Scripts\activate
   pip install -r requirements.txt

如果不使用虚拟环境：

   pip install -r requirements.txt
   # 또는
   pip install requests python-dotenv

环境变量

- .env.example复制 .env 创建（在项目中使用）或 ~/.config/jira-helper/.env （全局使用） - 输入Jira Cloud URL、电子邮件和API令牌

   cp .env.example .env
   # .env 편집: JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN

API令牌发放： Atlassian API令牌在中创建（使用代替密码）

使用方法

打开并运行虚拟环境：

cd ~/jira-helper
source .venv/bin/activate   # Windows: .venv\Scripts\activate
python jira_cli.py list

要在没有虚拟环境的情况下一次性运行，请直接指定项目的Python:

~/jira-helper/.venv/bin/python ~/jira-helper/jira_cli.py list

命令示例

# 내 미완료 티켓 목록 (기본)
python jira_cli.py list

# 내 완료 티켓만
python jira_cli.py list --status done

# 전체(미완료+완료)
python jira_cli.py list --status all

# 티켓 상세 보기
python jira_cli.py show PROJ-123

# JQL로 검색
python jira_cli.py search "project = MYPROJ AND status = 'In Progress'"
python jira_cli.py search "assignee = currentUser() ORDER BY updated DESC" -n 10

# 티켓 착수 (In Progress로 전환)
python jira_cli.py start PROJ-123

# 티켓 상태 변경 (Resolved, Closed 등)
python jira_cli.py transition PROJ-123 Resolved

# 티켓 생성 (프로젝트, 제목; --type, -d, --assign-me 선택)
python jira_cli.py create PROJ "새 작업 제목"
python jira_cli.py create PROJ "버그 요약" --type Bug -d "재현 절차" --assign-me
# CLOSET Bug는 config 기본값 적용. 덮어쓰기: --custom-fields '{"customfield_10648":{"id":"12601"}}'

# 티켓 수정 (제목·설명·담당자)
python jira_cli.py edit PROJ-123 -s "새 제목"
python jira_cli.py edit PROJ-123 -d "새 설명" --assign-me

Shell别名（可选）

~/.zshrc添加到 jira list可以像这样使用。要在虚拟环境中使用Python：

alias jira='~/jira-helper/.venv/bin/python ~/jira-helper/jira_cli.py'

如果您在没有虚拟环境的情况下使用系统Python：

alias jira='python ~/jira-helper/jira_cli.py'

在其他项目中使用

在任何目录中 jira 要使用命令 全局安装哇 全局设置写就可以了。

1.全局安装

pipx （建议：作为专用虚拟环境安装，与其他软件包隔离）：

pipx install ~/jira-helper
# 또는 GitHub 클론 후
git clone https://github.com/your-id/jira-helper.git && pipx install ./jira-helper
# 개발 중 변경 반영하려면: pipx install -e ~/jira-helper

点（在现有虚拟环境中安装）：

cd ~/jira-helper
pip install -e .

安装后 jira 命令在PATH中注册。

2.加载设置的顺序

CLI按以下顺序查找设置文件：

JIRA_ENV 为环境变量指定的文件路径
当前目录的 .env
~/.config/jira helper/.env （全局默认值）

在其他项目中使用相同的Jira时，只需保留一个全局设置即可。

mkdir -p ~/.config/jira-helper
cp ~/jira-helper/.env.example ~/.config/jira-helper/.env
# ~/.config/jira-helper/.env 편집

如果您只想为特定项目使用不同的Jira（不同的URL/帐户），请在该项目目录中 .env如果存在，则只有在该目录中运行时才使用该设置。

3.使用示例

cd ~/any-project
jira list
jira show PROJ-123

用作MCP服务器（Cursor等）

注册为模型上下文协议（MCP）服务器时，Cursor将 “帮我查一下吉拉的门票目录”，\*\*可以像“出示PROJ-123门票”\*\*一样用自然语言请求。

全局MCP（用于所有Cursor项目）

使用pipx进行全局安装 （仅一次）：

   pipx install -e ~/jira-helper

jira, jira-mcp 命令在PATH中注册。

全局设置文件 (~/.config/jira-helper/.env):

   mkdir -p ~/.config/jira-helper
   cp ~/jira-helper/.env.example ~/.config/jira-helper/.env
   # ~/.config/jira-helper/.env 에 JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN 입력

MCP服务器当前目录 .env如果没有，则使用此文件。

Cursor全局MCP设置 (~/.cursor/mcp.json):

mcpServers在中添加以下内容：

   "jira-helper": {
     "command": "jira-mcp"
   }

重新启动Cursor后，可以在所有工作空间中写入jira-helper MCP。

特定于项目的MCP（仅此项目）

如果您只想在该项目中使用MCP，请使用项目虚拟环境中的Python mcp_server.py直接运行。（无全局安装）

依赖性安装

   cd ~/jira-helper
   pip install -e .
   # (mcp는 기본 의존성에 포함됨)

在Cursor中注册MCP服务器 （项目 .cursor/mcp.json)

   {
     "mcpServers": {
       "jira-helper": {
         "command": "~/jira-helper/.venv/bin/python",
         "args": ["~/jira-helper/mcp_server.py"]
       }
     }
   }

如果克隆到了其他路径，请切换到该路径。

交付工具

工具	说明
jira_list	分配给我的票证列表（status:open/done/all，max_results）
jira_show	一张票详细信息（issue_key）
jira_search JQL搜索（jql，max_results）
jira_transition	更改票证状态（issue_key、target_status:In Progress/Resolved/Closed等）
jira-create	티켓 생성 （项目密钥、摘要、问题类型、描述、assign_to_self、custom_fields_json）
jira.edit	티켓 수정 （issue_key、摘要、描述、assign_to_self）

具有Bug等必要自定义字段的项目（例如CLOSET）\ config/required_fields.json如果存在默认值，则会自动应用。选项值·覆盖方法 docs/MCP_REQUIRED_FIELDS.md 参考。

设置与CLI相同 JIRA_ENV, .env（当前目录）， ~/.config/jira helper/.env 按顺序加载。

在Cursor中参考票证

如果在代码工作时说“请根据PROJ-123票证进行修改”，请使用此CLI show PROJ-123 可以参考结果进行操作。\ 打开MCP服务器后，Cursor将直接 jira_show 可以调用等获取票证内容。\ 如果愿意的话 .cursor/rules您还可以在中添加在提交/分支中包含Jira票号的规则。

目录标签

开发工具PythonCursor命令行工具Jira本地部署CLI工具RESTAPI票务管理开发效率

支持客户端

Cursor

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Python

工具数量（toolCount，工具数）

6

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/077d277c27161a8daede1b312aa0da9e

一个通过Jira Cloud REST API进行票务查询、搜索和状态转换的简单命令行工具。

继续浏览同类 MCP

更多办公协作 MCP（2,235）返回 MCP 目录

上一个 MCP

Jira Delivery MCP

Jira Delivery MCP是一个围绕本地MCP服务器、可重用策略模块和可选Codex技能包的Jira操作工具包，适用于需要AI辅助但不想失去确定性工具、工作流意识或可审计性的团队。

下一个 MCP

Jira Issue MCP Server

Enables interaction with Jira through OAuth 2.0 to create and manage issues directly from MCP-compatible clients. It supports secure authentication and local token caching to facilitate automated task management within Jira projects.

Jira Helper