JinDaGe - jira-mcp-server MCP Details

article

README

🚀 Jira通信服务器MCP服务器

这是一个基于TypeScript的MCP服务器，为与Jira进行交互提供了一系列实用工具。它通过执行JQL查询、创建编辑删除Jira票证、列出Jira项目和状态等核心功能，充分展示了MCP概念，能有效提升与Jira系统交互的效率。

🚀 快速开始

此Jira通信服务器MCP服务器可帮助您便捷地与Jira系统进行交互，您可以按照以下步骤开启使用。

✨ 主要特性

Jira工具

execute_jql：运行JQL查询，可指定查询语句和结果数量。
get_only_ticket_name_and_description：获取票证的名称和描述，可指定查询语句和结果数量。
create_ticket：创建Jira票证，需提供项目键、摘要、描述、问题类型名称等信息。
list_projects：列出Jira项目，可指定结果数量。
delete_ticket：根据票证ID或键删除票证。
edit_ticket：修改票证信息，可选择性修改摘要、描述、标签等内容。
get_all_statuses：获取所有状态，可指定结果数量。
assign_ticket：将票证分配给指定用户。
query_assignable：在项目中查找可分配的用户。
add_attachment：向票证添加附件。

📦 安装指南

开发环境安装

安装依赖：

npm install

构建服务器：

npm run build

带有自动重建的开发：

npm run watch

与Claude Desktop一起使用时的安装

与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，在您的浏览器中打开即可。

jira-mcp-server