1broseidon_mcp-jira-server

🚀 Jira MCP 服务器

Jira MCP 服务器是一个与 Jira REST API 集成的 Model Context Protocol (MCP) 服务器，它使 AI 助手能够以编程方式管理 Jira 问题，为 Jira 问题管理提供了高效便捷的解决方案。

✨ 主要特性

该服务器提供了一系列管理 Jira 问题的实用工具：

• 创建问题：可创建新的任务、史诗、子任务等不同类型的问题。
• 列出问题：支持列出问题，并可根据状态进行过滤。
• 更新问题：能够更新现有问题的标题、描述和状态等信息。
• 获取详情：可以获取问题的详细信息。
• 删除问题：允许删除指定的 Jira 问题。
• 添加评论：支持向问题添加评论。

📦 安装指南

先决条件

• 拥有具备 API 访问权限的 Jira 账户。
• 准备好 Jira API 令牌，可在 Atlassian 账户设置 生成。

安装步骤

1. 安装项目依赖：

npm install

2. 构建服务器：

npm run build

配置步骤

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

{
  "projectKey": "YOUR_PROJECT_KEY"
}

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

• 在 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：问题类型（任务、史诗或子任务）。

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

输出格式

问题信息将以以下格式显示：

• 问题密钥和标题
• 问题类型和状态
• 创建日期和创建者
• 描述
• 评论（如有）及其作者和时间戳