Jira V7.10.0 Mcp

by zhouqia

152 downloads

Not rated

GitHub

Developer Tools

About

Jira V7.10.0 Mcp is an MCP server that integrates with Jira Server v7.10.0 via its REST API v2, enabling AI assistants like Claude to perform project management and issue tracking operations through natural language commands.

Details

Author: zhouqia
Downloads: 152
Categories: Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Jira V7.10.0 Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

From the repository

Clone the repository, set environment variables JIRA_BASE_URL, JIRA_USERNAME, and JIRA_PASSWORD, then register with Claude Code using claude mcp add --scope user jira -e ... -- python -m jira_mcp. For standalone testing, export the variables and run python -m jira_mcp. Communication happens over stdio.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "jira v7.10.0 mcp": {
            "jira": {
                "type": "stdio",
                "command": "python3.13",
                "args": [
                    "-m",
                    "jira_mcp"
                ],
                "env": {
                    "JIRA_BASE_URL": "https://jira.company.net",
                    "JIRA_USERNAME": "JIRA_USERNAME",
                    "JIRA_PASSWORD": "JIRA_PASSWORD"
                }
            }
        }
    }
}

McpServers

{
    "jira": {
        "type": "stdio",
        "command": "python3.13",
        "args": [
            "-m",
            "jira_mcp"
        ],
        "env": {
            "JIRA_BASE_URL": "https://jira.company.net",
            "JIRA_USERNAME": "JIRA_USERNAME",
            "JIRA_PASSWORD": "JIRA_PASSWORD"
        }
    }
}

Jira MCP Server

基于 Model Context Protocol (MCP) 的 Jira Server 集成服务，让 Claude 等 AI 助手能够直接与 Jira 交互，完成项目管理和问题跟踪操作。

背景

在 OPC（Operator-Computer）协作模式下，MCP 是 AI 助手"链接世界"的关键基础设施。无论是企业协作还是个人效率提升，都需要构建和使用大量的 MCP 来打通各类工具。

Jira 作为广泛使用的需求和项目管理工具，自然是 MCP 生态中不可或缺的一环。然而，MCP Store 中现有的 Jira MCP 大多面向较新的 Jira 版本（Cloud / Data Center 8.x+），对于仍在使用老版本 Jira Server 的团队，兼容性难以保证。

本项目专为 Jira Server v7.10.0 构建，基于稳定的 REST API v2 接口。如果你的团队也在使用较早版本的 Jira Server，希望这个工具恰好是你需要的。

功能列表

问题管理

- search_issues — 使用 JQL（Jira Query Language）搜索问题 - get_issue — 获取单个问题的详细信息 - create_issue — 创建新问题（支持设置类型、优先级、指派人、标签等） - update_issue — 更新已有问题的字段 - transition_issue — 通过工作流转换变更问题状态 - get_transitions — 获取问题可用的工作流转换列表

- get_comments — 获取问题的所有评论 - add_comment — 为问题添加评论

项目

- list_projects — 列出当前用户可访问的所有项目 - get_project_components — 获取项目的所有组件 - get_project_versions — 获取项目的所有版本（发布） - get_version — 获取特定版本的详细信息

元数据

- list_fields — 列出所有字段（含自定义字段），用于构建 JQL 查询 - list_issue_types — 列出所有问题类型（Bug、Task、Story、Epic 等） - list_priorities — 列出所有优先级级别 - list_statuses — 列出所有问题状态 - list_resolutions — 列出所有解决方案类型（Fixed、Won't Fix 等） - get_server_info — 获取 Jira 服务器版本及部署信息

前置条件

- Python 3.10+
- Jira Server 实例（已在 v7.10.0 上测试）及有效的账号凭证
- Claude Code（用于注册 MCP 服务）

安装

使用安装脚本

git clone https://github.com/zhouqia/jira-mcp.git cd jira-mcp 先编辑 install.sh，填入你的 Jira 凭证 vim install.sh

bash install.sh

手动安装

git clone https://github.com/zhouqia/jira-mcp.git
cd jira-mcp
pip install -e .

配置

服务启动需要以下三个环境变量：

| 变量 | 说明 | 示例 |
|------|------|------|
| JIRA_BASE_URL | Jira Server 地址 | https://jira.example.com |
| JIRA_USERNAME | Jira 账号用户名 | your_username |
| JIRA_PASSWORD | Jira 账号密码 | your_password |

认证方式为 HTTP Basic Auth（此版本只支持基于账号密码的认证方式），基于 Jira REST API v2。

使用

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

注册完成后，即可在 Claude Code 对话中直接使用所有 Jira 工具。

独立运行（用于测试）

JIRA_BASE_URL="https://jira.example.com" \
JIRA_USERNAME="your_username" \
JIRA_PASSWORD="your_password" \
python -m jira_mcp

服务通过 stdio 协议与 MCP 客户端通信。

使用示例

注册后，你可以在 Claude Code 中用自然语言与 Jira 交互：

> 搜索 MYPROJ 项目中所有未关闭的 Bug > 在 MYPROJ 项目创建一个任务："更新 API 文档"，指派给 zhangsan，优先级设为 High > MYPROJ-123 目前是什么状态？帮我加一条评论："已在预发布环境验证通过" > 查看最近 7 天内我被指派的、状态发生变更的问题

> 列出 MYPROJ 项目的所有版本

项目结构

jira-mcp/
├── README.md
├── pyproject.toml              # 项目元数据与依赖声明
├── install.sh                  # 自动化安装脚本
└── src/
    └── jira_mcp/
        ├── __init__.py
        ├── __main__.py         # 入口（python -m jira_mcp）
        ├── server.py           # MCP 服务端 & 工具定义
        └── jira_client.py      # Jira REST API v2 异步客户端

技术细节

- Jira API: REST API v2（/rest/api/2/）
- 传输协议: stdio（标准输入/输出）
- HTTP 客户端: httpx（异步）
- MCP SDK: [mcp[cli]](https://pypi.org/project/mcp/)（Anthropic 官方 SDK）
- 请求超时: 30 秒

许可证

MIT

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Jira MCP Server

背景

功能列表

问题管理

评论

项目

元数据

前置条件

安装

使用安装脚本

先编辑 install.sh，填入你的 Jira 凭证

手动安装

配置

使用

注册到 Claude Code

独立运行（用于测试）

使用示例

项目结构

技术细节

许可证

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright