Jira MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于使用jira-python库与 Jira 的 REST API 进行交互。该服务器与 Claude Desktop 和其他 MCP 客户端集成，允许您使用自然语言命令与 Jira 交互。

特征

获取所有可访问的 Jira 项目
获取特定 Jira 问题的详细信息
使用 JQL（Jira 查询语言）搜索问题
创建新的 Jira 问题
对问题添加评论
获取问题的可用转换
将问题过渡到新状态

安装

先决条件

Python 3.9 或更高版本
Jira 实例（云、服务器或数据中心）
uv （可选，但建议用于依赖管理）

激活虚拟环境（推荐）

# Install a Virtual Environment (VENV) in the mcp server directory python -m venv . # Activate the virtual environment source bin/activate

使用 uv（推荐）

# Install uv if you don't have it pip install uv # Install the Jira MCP server uv pip install mcp-server-jira

使用 pip

pip install mcp-server-jira

配置

环境变量

使用环境变量配置服务器：

JIRA_SERVER_URL ：你的 Jira 服务器的 URL
JIRA_AUTH_METHOD ：身份验证方法（'basic_auth'或'token_auth'）
JIRA_USERNAME ：基本身份验证的用户名
JIRA_PASSWORD ：基本身份验证的密码
JIRA_TOKEN ：API 令牌或个人访问令牌

环境文件（本地开发）

您还可以使用您的配置在根目录中创建.env文件：

JIRA_SERVER_URL=https://your-jira-instance.atlassian.net JIRA_AUTH_METHOD=basic_auth JIRA_USERNAME=your_email@example.com JIRA_TOKEN=your_api_token

用法

命令行

python -m mcp_server_jira

Docker

docker build -t mcp-jira . docker run --env-file .env -p 8080:8080 mcp-jira

Claude 桌面集成

要将此服务器与 Claude Desktop 一起使用：

使用上述方法之一安装服务器
在 Claude Desktop 中：
- 前往“设置”->“开发者”
- 单击编辑配置
- 在您选择的编辑器中打开 json 配置
- 添加以下 JSON：（ NOTE ：所使用的环境变量用于令牌身份验证，不适用于其他身份验证方法）

{ "mcpServers": { "jira": { "command": "<PATH TO UV> i.e. /Users/<MYUSERNAME>/.local/bin/uv", "args": [ "--directory", "<PATH TO JIRA MCP>", "run", "mcp-server-jira" ], "env": { "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/", "JIRA_AUTH_METHOD": "token_auth", "JIRA_USERNAME": "<USERNAME>", "JIRA_TOKEN": "<TOKEN>" } } } }

现在您可以通过向 Claude 询问以下问题与 Jira 进行交互：
- “在 Jira 中显示我的所有项目”
- “获取问题 PROJECT-123 的详细信息”
- “在项目中创建一个新的错误，摘要为‘修复登录问题’”
- “查找分配给我的所有未解决的错误”

验证

服务器支持多种认证方式：

基本身份验证

对于 Jira Server/Data Center，用户名和密码如下：

JIRA_SERVER_URL="https://jira.example.com" JIRA_AUTH_METHOD="basic_auth" JIRA_USERNAME="your_username" JIRA_PASSWORD="your_password"

API 令牌（Jira Cloud）

对于使用 API 令牌的 Jira Cloud：

JIRA_SERVER_URL="https://your-domain.atlassian.net" JIRA_AUTH_METHOD="basic_auth" JIRA_USERNAME="your_email@example.com" JIRA_TOKEN="your_api_token"

个人访问令牌（Jira 服务器/数据中心）

对于使用 PAT 的 Jira Server/Data Center（8.14+）：

JIRA_SERVER_URL="https://jira.example.com" JIRA_AUTH_METHOD="token_auth" JIRA_TOKEN="your_personal_access_token"

可用工具

get_projects ：获取所有可访问的 Jira 项目
get_issue ：通过键获取特定 Jira 问题的详细信息
search_issues ：使用 JQL 搜索 Jira 问题
create_issue ：创建一个新的 Jira 问题
add_comment ：向 Jira 问题添加评论
get_transitions ：获取 Jira 问题可用的工作流转换
transition_issue ：将 Jira 问题转换为新状态

执照

麻省理工学院

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

Jira MCP Server