使用说明
Jira本地MCP服务器
A. 模型上下文协议（MCP） 连接AI客户端的服务器，如 光标 和 克劳德桌面版 到一个自托管 Jira服务器/数据中心 例子
Atlassian的官方MCP插件仅支持Jira Cloud。该项目弥合了内部安装的差距。
AI Client (Cursor / Claude) ←→ This MCP Server ←→ Jira Server REST API
特性
31工具 分为六类：
核心
| 工具 | 说明 |
|---|---|
get_issue |
按关键字获取问题 |
search_issues |
使用JQL搜索 |
my_issues |
您的未决问题 |
create_issue |
创建新问题 |
add_comment |
对一个问题的评论 |
get_comments |
阅读所有评论 |
get_transitions |
列出可用的状态转换 |
transition_issue |
将问题移动到新状态 |
get_projects |
列出所有可见项目 |
whoami |
当前用户配置文件 |
问题管理
| 工具 | 说明 |
|---|---|
update_issue |
编辑摘要、描述、优先级、标签 |
assign_issue |
重新分配问题 |
delete_issue |
删除问题 |
link_issues |
链接两个问题（块、关联、重复等） |
add_watcher |
为用户订阅问题 |
get_worklogs |
查看记录的时间 |
log_work |
记录问题的时间 |
搜索和报告
| 工具 | 说明 |
|---|---|
issues_updated_today |
Standup助手-您的问题今天更新，按状态分组 |
issues_updated_yesterday |
昨天也一样（周一有用） |
issues_by_status |
按状态筛选项目 |
issues_created_this_week |
本周新问题 |
overdue_issues |
逾期未解决的问题 |
get_filters |
您保存/喜爱的JQL筛选器 |
用户和团队
| 工具 | 说明 |
|---|---|
find_user |
按姓名/用户名搜索用户 |
get_team_issues |
多个团队成员的未决问题 |
附件
| 工具 | 说明 |
|---|---|
get_attachments |
列出问题的附件 |
add_attachment |
将本地文件上传到问题 |
敏捷/冲刺
| 工具 | 说明 |
|---|---|
get_boards |
列出Scrum和看板 |
get_sprints |
冲刺板 |
get_sprint_issues |
冲刺中的问题 |
move_to_sprint |
将问题转移到冲刺阶段 |
设置
先决条件
- Python 3.10+
- 具有REST API访问权限的Jira服务器/数据中心实例
- 个人访问令牌（PAT）或用户名/密码
安装
git clone https://github.com/JainArpit2001/jira-mcp-server.git
cd jira-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
配置
cp .env.example .env
编辑 .env 使用您的Jira URL和凭据。要生成PAT，请转到Jira个人资料→ 个人访问令牌 → 创建令牌.
测试
python server.py
服务器启动并监听stdio。按 Ctrl+C 停止。
对于与MCP检查员的交互式测试：
mcp dev server.py
连接到光标
添加 ~/.cursor/mcp.json:
{
"mcpServers": {
"jira-onprem": {
"command": "/path/to/jira-mcp-server/.venv/bin/python",
"args": ["/path/to/jira-mcp-server/server.py"]
}
}
}
重新启动Cursor，工具将可用。
连接到克劳德桌面
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"jira-onprem": {
"command": "/path/to/jira-mcp-server/.venv/bin/python",
"args": ["/path/to/jira-mcp-server/server.py"]
}
}
}
认证
支持两种方法（建议使用PAT）：
| 方法 | 环境变量 | 注释 |
|---|---|---|
| 专利审查高速路 （推荐） | JIRA_PAT |
根据Jira配置文件生成 |
| 基本认证 （回退） | JIRA_USERNAME, JIRA_PASSWORD |
仅在以下情况下使用 JIRA_PAT 为空 |
延伸
要添加新工具，请执行以下操作：
- 查找 Jira REST API端点
- 添加a
@mcp.tool()装饰异步函数server.py - 呼叫
_jira_request()（REST API v2）或_agile_request()（敏捷API） - 返回JSON字符串
许可证
麻省理工学院
