Jira MCP Server

Jira MCP Server

未知

GitHub
Created By1broseidon1broseidon

概述

Jira MCP 服务器允许 AI 助手通过编程方式与 Jira REST API 交互，用于创建、查询和管理 Jira 问题。

安装设置

  1. 安装依赖并构建服务器

    npm install
npm run build

  2. 创建配置文件

    在工作目录创建 .jira-config.json：

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

  3. 配置 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
list_issues列出项目问题working_dir, 可选 status
update_issue更新现有问题working_dir, issue_key, 可选 summary/description/status
get_issue获取问题详情working_dir, issue_key
delete_issue删除问题working_dir, issue_key
add_comment添加问题评论working_dir, issue_key, comment

使用示例

创建新问题：

create_issue(
  working_dir="/path/to/config",
  summary="实现登录功能",
  description="创建用户登录界面和后端验证逻辑",
  type="Task"
)

获取项目问题列表：

list_issues(
  working_dir="/path/to/config",
  status="进行中"
)

开发

运行自动重建：

npm run watch

注意事项

  • 确保有效的 Jira API 令牌（从 Atlassian 账户设置 获取）
  • 所有工具都需要 working_dir 参数指向配置文件位置
  • 服务器包含全面的错误处理，针对无效配置、认证错误等情况