🚀 Jira MCP 服务器
Jira MCP 服务器是一个与 Jira REST API 集成的 Model Context Protocol 服务器，它能让 AI 助手以编程的方式管理 Jira 问题，极大提升问题管理的效率。
✨ 主要特性
此服务器提供了一系列管理 Jira 问题的实用工具：
- 🆕 创建新问题（任务、史诗、子任务）
- 📜 列出问题，还能根据状态进行过滤
- 🔄 更新现有问题（标题、描述、状态）
- 📋 获取详细的问题信息
- 🗑️ 删除问题
- 💬 向问题添加评论
📦 安装指南
安装前准备
- 你需要一个具有 API 访问权限的 Jira 账户。
- 准备好 Jira API 令牌，可在 Atlassian 账户设置 中生成。
安装步骤
- 安装依赖项：
npm install
- 构建服务器：
npm run build
🔧 配置说明
- 在工作目录中创建一个
.jira-config.json文件：
{
"projectKey": "YOUR_PROJECT_KEY"
}
- 使用 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: 问题类型（任务、史诗、子任务）
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 身份验证错误
- ❌ 无效的状态转换
📚 详细文档
输出格式
问题信息会被格式化为包含以下内容：
- 问题密钥和标题
- 问题类型和状态
- 创建日期和创建者
- 描述
- （如果有）评论作者和时间戳