Jira MCP Server

Jira MCP 服务

一个模型上下文协议服务，可与 Jira 的 REST API 集成，让 AI 助手以编程方式管理 Jira 问题。

功能

此服务提供用于管理 Jira 问题的工具：

• 创建新问题（任务、史诗、子任务）
• 列出问题，并可按状态筛选
• 更新现有问题（摘要、描述、状态）
• 获取问题的详细信息
• 删除问题
• 为问题添加评论

设置

前提条件

1. 拥有可访问 API 的 Jira 账户
2. Jira API 令牌（可在 Atlassian Account Settings 中生成）

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude 桌面端安装 Jira Server：

npx -y @smithery/cli install jira-server --client claude

手动安装

1. 安装依赖项：

npm install

2. 构建服务：

npm run build

配置

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

{
  "projectKey": ["YOUR_PROJECT_KEY", "YOUR_OTHER_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": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

可用工具

create_issue

创建新的 Jira 问题

• 必需参数：
  • working_dir：包含 .jira-config.json 的目录
  • summary：问题标题
  • description：问题描述
  • type：问题类型（Task、Epic 或 Subtask）

list_issues

列出项目中的问题

• 必需参数：
  • working_dir：包含 .jira-config.json 的目录
• 可选参数：
  • status：按状态筛选（例如，“To Do”“In Progress”“Done”）

update_issue

更新现有问题

• 必需参数：
  • working_dir：包含 .jira-config.json 的目录
  • issue_key：问题键（例如，PRJ-123）
• 可选参数：
  • summary：新标题
  • description：新描述
  • status：新状态

get_issue

获取特定问题的详细信息

• 必需参数：
  • working_dir：包含 .jira-config.json 的目录
  • issue_key：问题键（例如，PRJ-123）

delete_issue

删除 Jira 问题

• 必需参数：
  • working_dir：包含 .jira-config.json 的目录
  • issue_key：问题键（例如，PRJ-123）

add_comment

为现有问题添加评论

• 必需参数：
  • working_dir：包含 .jira-config.json 的目录
  • issue_key：问题键（例如，PRJ-123）
  • comment：要添加的评论文本

开发

启用自动重新构建进行开发：

npm run watch

错误处理

该服务为以下情况提供全面的错误处理：

• 项目键无效
• 缺少配置
• 问题类型无效
• API 身份验证错误
• 状态转换无效

输出格式

问题信息的格式包括：

• 问题键和摘要
• 问题类型和状态
• 创建日期和创建者
• 描述
• 评论（如有），以及作者和时间戳