SuperAPI AI 工具集

jira-mcp-server

jira-mcp-server 是一个基于 TypeScript 的 MCP(Model Context Protocol)服务器,用于通过 JQL 查询和 API 与 Jira 交互,并支持创建、编辑、删除工单。它提供执行 JQL 查询、获取工单名称与描述、创建 Jira 工单、列出 Jira 项目和状态、删除工单、修改工单、分配工单、查询可分配用户、从公开 URL 或 Confluence 页面添加工单附件等工具。该仓库定位为 jira mcp server 的测试项目,演示核心 MCP 概念,可与 Claude Desktop 配合使用。

访问官网

工具介绍

jira-mcp-server 是一个基于 TypeScript 的 MCP 服务器,用于与 Jira 交互。根据项目资料,它通过提供一系列工具来演示核心 MCP 概念,并作为 jira mcp server 的测试项目。

主要能力

该服务器提供的工具及其用途、参数如下:

  • 执行 JQL 查询:用途是运行 JQL 查询;参数为 jql、number_of_results(默认:1)。
  • get_only_ticket_name_and_description:用途是获取工单名称和描述。
  • 创建 Jira 工单:参数为 project.key、summary、description、issuetype.name、parent(可选)。
  • 列出 Jira 项目:参数为 number_of_results(默认:1)。
  • 删除工单:参数为 issueIdOrKey。
  • 修改工单:参数为 issueIdOrKey、summary(可选)、description(可选)、labels(可选)、parent(可选)。
  • get_all_statuses:用途是检索所有状态。
  • 分配工单给用户:参数为 accountId、issueIdOrKey。
  • query_assignable:用途是查找项目中可分配的用户;参数为 project_key。
  • add_attachment_from_public_url:用途是从公开 URL 向工单添加附件;参数为 issueIdOrKey、imageUrl。
  • add_attachment_from_confluence:用途是从 Confluence 页面向工单添加附件;参数为 issueIdOrKey、pageId、attachmentName。

使用方式

项目为 TypeScript 代码,使用前需要安装依赖并构建服务器。资料提供了以下步骤:

  1. 安装依赖:npm install
  2. 构建服务器:npm run build
  3. 开发时使用自动重建:npm run watch

要与 Claude Desktop 配合使用,需要添加服务器配置,配置文件位置为:

  • MacOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%/Claude/claude_desktop_config.json

由于 MCP 服务器通过 stdio 通信,调试可能具有挑战性。项目建议使用 MCP Inspector,它作为包脚本提供,会提供一个 URL 以便在浏览器中访问调试工具。

适用场景和限制

该项目定位为测试性质的 jira mcp server,适合用于了解或验证 MCP 与 Jira 的集成能力,例如通过 JQL 查询数据、创建和编辑工单等场景。资料未提供关于正式生产使用、授权认证、安全性、性能或价格等方面的说明;具体的 MCP 配置内容、依赖名称与版本、调试脚本名称、以及 Jira API 版本等信息暂未提供。