Jira 通信服务器 MCP 服务器

与 Jira 交流

这是一个基于 TypeScript 的 MCP 服务器，提供与 Jira 交互的工具。它通过演示核心 MCP 概念来展示：

• 执行 JQL 查询的工具
• 创建、编辑和删除 Jira 工单的工具
• 列出 Jira 项目和状态的工具

功能

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。

开发

安装依赖：

npm install

构建服务器：

npm run build

带有自动重建的开发：

npm run watch

安装

要与 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，在您的浏览器中。