Jira通信服务器

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检查员，可作为包脚本使用：

npm run inspector

检查器将提供一个URL，用于访问浏览器中的调试工具。