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

检查器将提供一个访问调试工具的URL，在您的浏览器中打开即可。