🚀 Jira MCP 服务器

Jira MCP 服务器是一个借助 jira-python 库与 Jira REST API 进行交互的 Model Context Protocol (MCP) 服务器。它能够与 Claude Desktop 及其他 MCP 客户端集成，支持您通过自然语言命令与 Jira 展开交互。

✨ 主要特性

• 📋 获取所有可访问的 Jira 项目
• 📑 获取特定 Jira 问题的详细信息
• 🔍 使用 JQL（Jira 查询语言）搜索问题
• ➕ 创建新的 Jira 问题
• 💬 向问题添加评论
• 🔄 获取问题的可用过渡状态
• 🚀 将问题过渡到新状态

📦 安装指南

先决条件

• 🐍 Python 3.9 或更高版本
• 🌐 Jira 实例（云、服务器或数据中心）
• 📦 uv（可选但推荐用于依赖管理）

激活虚拟环境（推荐）

# 在 mcp 服务器目录中安装一个虚拟环境
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 中：
   • 转到设置 -> 开发人员
   • 点击编辑配置
   • 在您选择的编辑器中打开 JSON 配置文件
   • 添加以下 JSON： （注意：使用的环境变量适用于令牌身份验证，与其他身份验证方法不兼容）

{
  "mcpServers": {
    "jira": {
      "command": "<UV 安装路径> 例如 /Users/<用户名>/.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": "<您的 Jira 用户名>",
          "JIRA_TOKEN": "<您的访问令牌>"
        }
    }
  }
}

📄 许可证

本项目采用 MIT 许可证。