Jira MCP Server

Jira MCP Server

site icon
2025.04.29 0
TypeScriptJira 问题管理REST API 交互交流协作
Jira MCP Server 是一个用于与 Jira 进行通信的 MCP 服务器。它支持与 Jira Data Center 和 Jira Cloud 的 REST API 端点进行交互,目前主要测试了 Jira Cloud 的端点(`/rest/api/3`)。该服务器提供了一系列工具来管理 Jira 问题,包括获取、搜索、创建、分配、取消分配和编辑问题等功能。
View on GitHub

Overview

基本能力

产品定位

Jira MCP Server 是一个用于与 Jira 进行通信的 MCP 服务器,主要用于管理 Jira 问题。

核心功能

  • 获取问题(Get Issue By Key)
  • 搜索问题(Search Issues)
  • 创建问题(Create Issue)
  • 分配问题(Assign Issue)
  • 取消分配问题(Unassign Issue)
  • 编辑问题(Edit Issue)

适用场景

  • 在 MCP 客户端中集成 Jira 问题管理功能
  • 自动化 Jira 问题的创建、分配和编辑
  • 通过 REST API 与 Jira Cloud 进行交互

工具列表

  • Get Issue By Key:通过问题键获取 Jira 问题的详细信息。
  • Search Issues:搜索符合特定条件的 Jira 问题。
  • Create Issue:在 Jira 中创建新的问题。
  • Assign Issue:将问题分配给指定的用户。
  • Unassign Issue:取消问题的分配。
  • Edit Issue:编辑现有问题的详细信息。

常见问题解答

  • 目前仅测试了 Jira Cloud 的端点(/rest/api/3),Jira Data Center 的端点(/rest/api/2)可能不兼容。
  • 需要提供正确的环境变量(JIRA_PROJECT_URL, JIRA_USER_EMAIL, JIRA_API_KEY, JIRA_PROJECT_KEY)才能正常运行。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 克隆仓库并进入仓库目录。

安装教程

  1. 克隆仓库:git clone <repo-url>
  2. 进入仓库目录:cd jira-mcp-server
  3. 安装依赖:npm install
  4. 构建项目:npm run build

调试方式

  1. 确保所有环境变量已正确设置。
  2. 运行服务器:node build/index.js
  3. 检查 MCP 客户端配置是否正确。

MCP 客户端配置

将以下配置添加到 MCP 客户端的配置文件中:

{
  "mcpServers": {
    "jira-mcp-server": {
      "command": "node",
      "args": ["path-to-repo/jira-mcp-server/build/index.js"],
      "env": {
        "JIRA_PROJECT_URL": "https://project-url.atlassian.net/rest/api/3",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_API_KEY": "yourAPIkey",
        "JIRA_PROJECT_KEY": "ABC"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。