Jira MCP 服务器

一个提供与 Jira 的 REST API 集成的 Model Context Protocol 服务器，允许 AI 助手通过编程方式管理 Jira 问题。

特性

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

• 创建新问题（任务、史诗、子任务）
• 列出问题（可选状态过滤）
• 更新现有问题（概要、描述、状态）
• 获取详细的问题信息
• 删除问题
• 向问题添加评论

设置

先决条件

1. 一个具有 API 访问权限的 Jira 账户
2. Jira API 令牌（可以从 Atlassian 账户设置 生成）

安装

1. 安装依赖项：

npm install

1. 构建服务器：

npm run build

配置

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

{
  "projectKey": "YOUR_PROJECT_KEY"
}

1. 使用您的 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"
      }
    }
  }
}

可用工具

create_issue

创建一个新的 Jira 问题

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

list_issues

列出项目中的问题

• 必需参数：
  • working_dir: 包含 .jira-config.json 的目录
• 可选参数：
  • status: 按状态过滤（例如，“待办”，“进行中”，“完成”）

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 身份验证错误
• 无效的状态转换

输出格式

问题信息格式化为包含：

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