Jira MCP 服务器
一个模型上下文协议 (MCP) 服务器，用于使用jira-python库与 Jira 的 REST API 进行交互。该服务器与 Claude Desktop 和其他 MCP 客户端集成，允许您使用自然语言命令与 Jira 交互。
特征
获取所有可访问的 Jira 项目
获取特定 Jira 问题的详细信息
使用 JQL（Jira 查询语言）搜索问题
创建新的 Jira 问题
对问题添加评论
获取问题的可用转换
将问题过渡到新状态
Related MCP server: Jira MCP Server
安装
先决条件
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 服务器的 URLJIRA_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_jiraDocker
docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jiraClaude 桌面集成
要将此服务器与 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 问题转换为新状态
执照
麻省理工学院