mcp-jira-server

Jira MCP 服务器

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

特征

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

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

设置

先决条件

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

安装

1. 安装依赖项：

2. 构建服务器：

配置

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

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

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

可用工具

创建问题

创建新的 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）
  • 评论：要添加的评论文本

发展

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

错误处理

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

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

输出格式

问题信息的格式包括：

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