Jira MCP 服务器

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

功能

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

安装

前提条件

• Python 3.9 或更高版本
• 一个 Jira 实例（Cloud、Server 或 Data Center）
• uv（可选，但推荐用于依赖管理）

激活虚拟环境（推荐）

# 在 mcp 服务器目录中安装虚拟环境 (VENV)
python -m venv .
# 激活虚拟环境
source bin/activate

使用 uv (推荐)

# 如果您没有 uv，请安装它
pip install uv

# 安装 Jira MCP 服务器
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 Desktop 集成

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

1. 使用上述方法之一安装服务器
2. 在 Claude Desktop 中：
   • 转到 Settings -> Developer
   • 单击 Edit Config
   • 在您选择的编辑器中打开 json 配置
   • 添加以下 JSON： (注意: 使用的环境变量用于令牌身份验证，不适用于其他身份验证方法)

{
  "mcpServers": {
    "jira": {
      "command": "<UV 的路径> 例如 /Users/<MYUSERNAME>/.local/bin/uv",
      "args": [
          "--directory",
          "<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>"
      }
    }
  }
}

3. 现在，您可以通过向 Claude 提问来与 Jira 交互，例如：
   • "Show me all my projects in Jira"
   • "Get details for issue PROJECT-123"
   • "Create a new bug in the PROJECT with summary 'Fix login issue'"
   • "Find all open bugs assigned to me"

身份验证

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

基本身份验证

对于具有用户名和密码的 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 Server/Data Center)

对于使用 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"

可用工具

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 问题转换为新状态

许可证

MIT