使用说明

项目简介

Jira MCP Server 作为一个桥梁，连接了 Claude Desktop 等 MCP 客户端和 Jira 项目管理工具。它允许用户通过自然语言指令，在 Claude Desktop 中直接操作 Jira，无需手动访问 Jira 界面，从而提升项目管理效率。

主要功能点

• 问题管理: 支持创建、更新、删除和检索 Jira 中的问题和子任务。
• 用户管理: 允许通过邮箱地址查询 Jira 用户账户 ID。
• 问题链接: 支持创建 Jira 问题之间的链接关系。
• 配置查询: 可以列出 Jira 中可用的问题类型和链接类型等配置信息。

安装步骤

1. 克隆仓库: 在本地克隆 Jira MCP Server 仓库到您的计算机。

   git clone https://github.com/George5562/Jira-MCP-Server.git
   cd Jira-MCP-Server
   

2. 安装依赖: 使用 npm 安装项目所需的依赖包。

   npm install
   

3. 配置环境变量: 在项目根目录下创建 '.env' 文件，并填入您的 Jira 实例信息。

   JIRA_HOST=your-instance.atlassian.net  # 您的 Jira 实例主机名
   [email protected]      # 您的 Jira 账户邮箱
   JIRA_API_TOKEN=your-api-token          # 您的 Jira API Token (在 https://id.atlassian.com/manage-profile/security/api-tokens 获取)
   

4. 构建项目: 编译 TypeScript 代码。

   npm run build
   

5. 启动服务器: 运行 Jira MCP Server。

   npm start
   

服务器配置

要将 Jira MCP Server 与 MCP 客户端（如 Claude Desktop）连接，您需要在客户端的配置文件中添加服务器配置信息。以下是 Claude Desktop 的配置示例，您需要根据实际情况修改 'cwd' 字段为 Jira MCP Server 仓库的绝对路径。

{
  "mcp_servers": [
    {
      "name": "jira-server",                  // 服务器名称，可以自定义
      "command": "npm start",                 // 服务器启动命令
      "cwd": "/path/to/jira-server",        // Jira MCP Server 仓库的绝对路径，例如：/Users/yourname/Jira-MCP-Server
      "env": {
        // 环境变量已在 .env 文件中配置，此处无需重复，除非需要覆盖
        // "JIRA_HOST": "your-instance.atlassian.net",
        // "JIRA_EMAIL": "[email protected]",
        // "JIRA_API_TOKEN": "your-api-token"
      }
    }
  ]
}

基本使用方法

配置完成后，在 Claude Desktop 中即可通过自然语言指令调用 Jira MCP Server 提供的工具，例如：

• "列出我的 Jira 项目中的所有 bug"
• "创建一个 Jira 任务，项目为 ABC，标题为 '修复用户登录问题'，指派给 [email protected]"
• "查询 [email protected] 的 Jira 用户 ID"

具体可使用的工具和参数，请参考仓库 'README.md' 文件中 "Available Tools" 部分的描述。