Jira communication server MCP Server

Jira communication server 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_from_public_url

• 用途：从公共 URL 向工单添加附件。
• 参数：issueIdOrKey、imageUrl。

add_attachment_from_confluence

• 用途：从 Confluence 页面向工单添加附件。
• 参数：issueIdOrKey、pageId、attachmentName。

开发

安装依赖：

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