🚀 Jira 通信服务器 MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器，主要用于与 Jira 进行交互。它提供了一系列实用工具，能帮助用户执行 JQL 查询、创建和管理 Jira 工单、查看 Jira 项目和状态等，极大地提升了与 Jira 交互的效率。

🚀 快速开始

本服务器是基于 TypeScript 开发的 MCP 服务器，旨在为用户提供与 Jira 交互的便捷工具。通过一系列实用的工具函数，用户可以轻松地执行 JQL 查询、管理 Jira 工单等。

✨ 主要特性

• 执行 JQL 查询的工具：可根据用户需求执行 JQL 查询，获取所需的工单信息。
• 创建、编辑和删除 Jira 工单的工具：支持对 Jira 工单进行全生命周期管理，包括创建、编辑和删除操作。
• 列出 Jira 项目和状态的工具：方便用户查看 Jira 中的项目和工单状态。

📦 安装指南

安装依赖

npm install

构建服务器

npm run build

带有自动重建的开发

npm run watch

与 Claude Desktop 一起使用

要与 Claude Desktop 一起使用，请添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Jira communication server": {
      "command": "node",
      "args": [
        "/PATH_TO_THE_PROJECT/build/index.js"
      ],
      "env": {
        "JIRA_URL": "https://XXXXXXXX.atlassian.net",
        "JIRA_API_MAIL": "Your email",
        "JIRA_API_KEY": "KEY_FROM : https://id.atlassian.com/manage-profile/security/api-tokens"
      }
    }
  }
}

调试

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们推荐使用 MCP Inspector，它作为包脚本可用：

npm run inspector

Inspector 将提供一个访问调试工具的 URL，在您的浏览器中。

📚 详细文档

Jira 工具

execute_jql

• 目的：执行 JQL 查询。
• 参数：jql，number_of_results（默认：1）。

get_only_ticket_name_and_description

• 目的：获取工单名称和描述。
• 参数：jql，number_of_results（默认：1）。

create_ticket

• 目的：创建 Jira 工单。
• 参数：project.key，summary，description，issuetype.name，parent（可选）。

list_projects

• 目的：列出 Jira 项目。
• 参数：number_of_results（默认：1）。

delete_ticket

• 目的：删除工单。
• 参数：issueIdOrKey。

edit_ticket

• 目的：修改工单。
• 参数：issueIdOrKey，summary（可选），description（可选），labels（可选），parent（可选）。

get_all_statuses

• 目的：获取所有状态。
• 参数：number_of_results（默认：1）。

assign_ticket

• 目的：将工单分配给用户。
• 参数：accountId，issueIdOrKey。

query_assignable

• 目的：在项目中查找可分配的用户。
• 参数：project_key。

add_attachment

• 目的：向工单添加附件。
• 参数：issueIdOrKey，imageUrl。