MCP Jira

Jira MCP服务器

模型上下文协议（MCP）服务器，用于使用 jira-python 图书馆。此服务器与Claude Desktop和其他MCP客户端集成，允许您使用自然语言命令与Jira交互。

特性

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

安装

先决条件

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

激活虚拟环境（推荐）

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

使用紫外线（推荐）

# 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 build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jira

Claude桌面集成

要将此服务器与Claude Desktop一起使用，请执行以下操作：

1. 使用上述方法之一安装服务器
2. 在克劳德桌面中：

- 转到设置->开发人员 - 单击编辑配置 - 在您选择的编辑器中打开json配置 - 添加以下JSON： (NOTE：使用的环境变量用于令牌Auth，不适用于其他身份验证方法）

{
  "mcpServers": {
    "jira": {
      "command": "
 i.e. /Users//.local/bin/uv",
      "args": [
          "--directory",
          "
",
          "run",
          "mcp-server-jira"
      ],
      "env": {
          "JIRA_SERVER_URL": "https://.atlassian.net/",
          "JIRA_AUTH_METHOD": "token_auth",
          "JIRA_USERNAME": "",
          "JIRA_TOKEN": ""
      }
    }
  }
}

1. 现在，您可以通过向Claude提出以下问题与Jira进行交互：

- “在Jira中显示我的所有项目” - “获取问题PROJECT-123的详细信息” - “在项目中创建一个新错误，摘要为‘修复登录问题’” - “查找分配给我的所有打开的Bug”

认证

服务器支持多种身份验证方法：

基本身份验证

对于具有用户名和密码的Jira服务器/数据中心：

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服务器/数据中心（8.14+）：

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

可用工具

1. get_projects：获取所有可访问的Jira项目
2. get_issue：按密钥获取特定Jira问题的详细信息
3. search_issues：使用JQL搜索Jira问题
4. create_issue：创建新的Jira问题
5. add_comment：向Jira问题添加评论
6. get_transitions：获取Jira问题的可用工作流转换
7. transition_issue：将Jira问题转换为新状态

许可证

麻省理工学院