Jira MCP Server

Jira MCP 服务

自 2026 年 9 月 29 日起停止维护。 此项目不再接收功能更新、错误修复、依赖更新或安全维护。现有代码仍依据 MIT 许可证提供。对于新的 Jira Cloud 集成，请使用官方 Atlassian Rovo MCP Server。

此本地 Model Context Protocol（MCP）服务通过 stdio 向 MCP 客户端开放 Jira 操作。其实现结合了 jira-python 和直接调用 Jira Cloud REST API v3 的请求。

此项目最初解决的 API 令牌身份验证缺口如今已由 Rovo 弥补。切换之前，请参阅迁移指南，了解身份验证要求、客户端设置和工作流检查。

兼容性

• Python 3.10 或更高版本。
• Jira Cloud，使用 Atlassian 账户邮箱和通过 basic_auth 使用的 API 令牌。
• 能够启动本地 stdio 服务的 MCP 客户端。

直接 API 客户端使用 /rest/api/3。本次停止维护的版本未验证与 Jira Server 和 Data Center（包括仅使用 PAT 的身份验证）的兼容性，也不支持这些配置。早期文档中声称支持这些配置的说法有误。保留的旧版身份验证分支并不代表端到端兼容。

可用工具

工具	用途
get_jira_projects	列出可访问的 Jira 项目。
get_jira_issue	按键获取问题。
search_jira_issues	使用 JQL 搜索问题。
create_jira_issue	创建一个问题。
create_jira_issues	通过 Jira 的批量 API 创建多个问题。
add_jira_comment	为问题添加评论。
get_jira_transitions	列出可用的工作流转换。
transition_jira_issue	将问题转换为另一种状态。
create_jira_project	创建项目，具体取决于 Jira 权限。
get_jira_project_issue_types	列出项目可用的问题类型。

旧版安装

检出此仓库以获取最终代码和文档。此前发布的软件包可能早于停止维护修复。

使用 uv 从源代码安装

安装 uv，然后：

git clone https://github.com/InfinitIQ-Tech/mcp-jira.git
cd mcp-jira
uv sync

使用 pip 从源代码安装

python -m venv .venv
source .venv/bin/activate
python -m pip install .

历史软件包安装命令为 uv pip install mcp-server-jira 和 python -m pip install mcp-server-jira。

旧版配置

为 Jira Cloud 设置以下环境变量：

export JIRA_SERVER_URL="https://your-domain.atlassian.net"
export JIRA_AUTH_METHOD="basic_auth"
export JIRA_USERNAME="[email protected]"
export JIRA_TOKEN="your_api_token"

JIRA_USERNAME 是 Atlassian 账户邮箱。JIRA_TOKEN 是该账户的 Jira Cloud API 令牌。JIRA_PASSWORD 和 token_auth 仍保留在旧版代码中，但不是推荐的 Jira Cloud 配置。请勿将凭据纳入版本控制。

仓库包含 .env.example。若要通过 uv 使用 .env 文件，请显式传入：

cp .env.example .env
# Edit .env with your Jira Cloud credentials.
uv run --env-file .env mcp-server-jira

如果已设置环境变量，请运行以下任一命令：

uv run mcp-server-jira

或者，在使用 pip 安装后运行：

python -m mcp_server_jira

Docker

此服务使用 stdio，而不是 HTTP 监听器。通过 MCP 客户端启动时，请保持 stdin 打开：

docker build -t mcp-jira .
docker run --rm -i --env-file .env mcp-jira

本地 MCP 客户端配置示例

对于支持 mcpServers 命令配置的客户端（例如 Claude Desktop），请使用 uv 和仓库检出目录的绝对路径：

{
  "mcpServers": {
    "jira": {
      "command": "/absolute/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/mcp-jira",
        "run",
        "mcp-server-jira"
      ],
      "env": {
        "JIRA_SERVER_URL": "https://your-domain.atlassian.net",
        "JIRA_AUTH_METHOD": "basic_auth",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_TOKEN": "your_api_token"
      }
    }
  }
}

客户端配置位置和支持的传输方式各不相同。此示例介绍的是旧版本地服务，并非 Rovo 配置，也不表示已测试过所有客户端。

迁移与维护

移除本地连接器之前，请遵循迁移到 Atlassian Rovo MCP。Rovo 是由 Atlassian 托管的服务，其身份验证方式、工具名称和响应架构均有所不同。配置无法自动迁移。

保留或分叉此代码的用户须自行负责后续维护，以及确保与 Jira 和 MCP 客户端的兼容性。

许可证

MIT