Jira MCP 服务器

模型上下文协议服务器提供与 Jira 的 REST API 的集成，允许 AI 助手以编程方式管理 Jira 问题。

特征

该服务器提供管理 Jira 问题的工具：

• 创建新问题（任务、史诗、子任务）

• 列出具有可选状态过滤的问题

• 更新现有问题（摘要、描述、状态）

• 获取详细的问题信息

• 删除问题

• 对问题添加评论

Related MCP server: JIRA MCP Server

设置

先决条件

1. 具有 API 访问权限的 Jira 帐户

2. Jira API 令牌（可从Atlassian 帐户设置生成）

安装

1. 安装依赖项：

npm install

2. 构建服务器：

npm run build

配置

1. 在您的工作目录中创建一个.jira-config.json文件：

{
  "projectKey": "YOUR_PROJECT_KEY"
}

2. 使用您的 Jira 凭据配置 MCP 服务器：

在 MacOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

可用工具

创建问题

创建新的 Jira 问题

• 必需参数：

  • working_dir：包含 .jira-config.json 的目录

  • 摘要：问题标题

  • 描述：问题描述

  • 类型：问题类型（任务、史诗或子任务）

列出问题

列出项目中的问题

• 必需参数：

  • working_dir：包含 .jira-config.json 的目录

• 可选参数：

  • 状态：按状态过滤（例如“待办”、“进行中”、“完成”）

更新问题

更新现有问题

• 必需参数：

  • working_dir：包含 .jira-config.json 的目录

  • issue_key：发行密钥（例如 PRJ-123）

• 可选参数：

  • 摘要：新标题

  • 描述：新描述

  • 状态：新状态

获取问题

获取有关特定问题的详细信息

• 必需参数：

  • working_dir：包含 .jira-config.json 的目录

  • issue_key：发行密钥（例如 PRJ-123）

删除问题

删除 Jira 问题

• 必需参数：

  • working_dir：包含 .jira-config.json 的目录

  • issue_key：发行密钥（例如 PRJ-123）

添加评论

向现有问题添加评论

• 必需参数：

  • working_dir：包含 .jira-config.json 的目录

  • issue_key：发行密钥（例如 PRJ-123）

  • 评论：要添加的评论文本

发展

对于使用自动重建的开发：

npm run watch

错误处理

该服务器包括针对以下方面的全面错误处理：

• 项目密钥无效

• 缺少配置

• 无效的问题类型

• API 身份验证错误

• 无效状态转换

输出格式

问题信息的格式包括：

• 问题关键和摘要

• 问题类型和状态

• 创建日期和创建者

• 描述

• 带有作者和时间戳的评论（如果有）