项目简介

JIRA MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在连接 JIRA 和大型语言模型 (LLMs)。它允许 LLMs 通过标准化的工具和上下文与 JIRA 进行交互，实现诸如 JQL 查询和获取 issue 详情的功能。

主要功能点

• JQL Search: 使用 JQL (Jira Query Language) 搜索 JIRA issues，支持分页和自定义返回字段。
• Issue Details: 获取指定 JIRA issue 的详细信息。

安装步骤

1. 确保已安装 'npm'。
2. 克隆仓库:

   git clone <repository-url>
   cd jira-mcp
   

3. 安装依赖:

   npm install
   

4. 配置 JIRA API 凭据：
   • 在仓库根目录下创建 '.env' 文件。
   • 在 '.env' 文件中设置以下环境变量：

     JIRA_INSTANCE_URL=https://your-instance.atlassian.net  # 你的 JIRA 实例 URL
     [email protected]             # 你的 JIRA 用户邮箱
     JIRA_API_KEY=your-api-token                        # 你的 JIRA API Token
     

   • 替换上述值为你实际的 JIRA 实例 URL、邮箱和 API Token。 (API Token 需要在 Atlassian 账户安全设置中创建)

服务器配置

对于 MCP 客户端（例如 Claude Desktop），需要配置以下信息以连接到 JIRA MCP Server。将以下 JSON 配置添加到 MCP 客户端的配置文件中，通常是 'claude_desktop_config.json'：

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net", // 替换为你的 JIRA 实例 URL
        "JIRA_USER_EMAIL": "[email protected]",            // 替换为你的 JIRA 用户邮箱
        "JIRA_API_KEY": "your-api-token"                       // 替换为你的 JIRA API Token
      }
    }
  }
}

基本使用方法

1. 按照服务器配置部分，将配置信息添加到 MCP 客户端（例如 Claude Desktop）的配置文件中。
2. 启动 MCP 客户端。客户端会自动通过 'npx -y jira-mcp' 命令启动 JIRA MCP Server。
3. 在 MCP 客户端中，可以使用 'jql_search' 和 'get_issue' 工具与 JIRA 进行交互。 例如，在 Claude 中，你可以指示 Claude 使用 'jql_search' 工具来查询 JIRA issues，或使用 'get_issue' 工具获取特定 issue 的详细信息。