Jira MCP Server

概述

Jira MCP 服务器提供了与 Jira REST API 的集成，让 AI 助手能够通过编程方式管理 Jira 问题，包括创建、列出、更新、删除问题以及添加评论等功能。

设置步骤

前提条件

• Jira 账户（具有 API 访问权限）
• Jira API 令牌（从 Atlassian 账户设置 生成）

安装

npm install
npm run build

配置

1. 创建 .jira-config.json 文件：

   {
     "projectKey": "您的项目密钥"
   }
   

2. 配置 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": "您的API令牌",
           "JIRA_DOMAIN": "您的域名"
         }
       }
     }
   }
   

主要功能

创建问题

create_issue(
  working_dir="路径", 
  summary="问题标题", 
  description="详细描述", 
  type="Task|Epic|Subtask"
)

列出问题

list_issues(
  working_dir="路径", 
  status="可选状态过滤" // 如"待办"、"进行中"
)

更新问题

update_issue(
  working_dir="路径", 
  issue_key="PRJ-123", 
  summary="可选新标题", 
  description="可选新描述", 
  status="可选新状态"
)

获取问题详情

get_issue(
  working_dir="路径", 
  issue_key="PRJ-123"
)

删除问题

delete_issue(
  working_dir="路径", 
  issue_key="PRJ-123"
)

添加评论

add_comment(
  working_dir="路径", 
  issue_key="PRJ-123", 
  comment="评论内容"
)

开发模式

npm run watch

服务器包含全面的错误处理机制，能够处理无效的项目密钥、缺失配置、API 认证错误等情况。