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 代码,使用前需要安装依赖并构建服务器。资料提供了以下步骤:
- 安装依赖: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
由于 MCP 服务器通过 stdio 通信,调试可能具有挑战性。项目建议使用 MCP Inspector,它作为包脚本提供,会提供一个 URL 以便在浏览器中访问调试工具。
适用场景和限制
该项目定位为测试性质的 jira mcp server,适合用于了解或验证 MCP 与 Jira 的集成能力,例如通过 JQL 查询数据、创建和编辑工单等场景。资料未提供关于正式生产使用、授权认证、安全性、性能或价格等方面的说明;具体的 MCP 配置内容、依赖名称与版本、调试脚本名称、以及 Jira API 版本等信息暂未提供。