Jira communication server MCP Server

Jira 通信服务 MCP Server

与 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，供你在浏览器中访问调试工具。