JinDaGe - jira-mcp-server MCP Details

article

README

🚀 Jira 问题跟踪系统说明文档

Jira 是一款被广泛应用的项目管理工具，主要用于跟踪与管理软件开发中的任务、缺陷以及用户故事。本项目提供了与 Jira 系统交互的多种功能，如创建和查询问题等。

🚀 快速开始

本项目提供了与 Jira 系统交互的功能，你可以按照后续的安装、配置步骤进行操作，然后使用相关命令来查询和创建问题。

📦 安装指南

1. 获取代码

使用 Git 克隆仓库：

git clone https://github.com/your-username/jira-tool.git

2. 安装依赖

进入项目目录并安装所需包：

npm install

📚 详细文档

配置说明

创建一个配置文件 config.json，内容如下：

{
  "jiraUrl": "https://your-domain.atlassian.net",
  "username": "your-username",
  "password": "your-password"
}

功能列表

1. 查询问题

列出指定项目中的所有问题。

npm run list-issues -- --projectKey PROJECT-KEY

2. 创建问题

新建一个问题到指定项目中：

npm run create-issue -- --projectKey PROJECT-KEY --title "问题标题" --description "问题描述"

参数说明

| 参数名称 | 类型 | 是否必填 | 描述 | | -------------- | ------ | -------- | ------------------------ | | projectKey | string | 是 | Jira 项目标识符 | | title | string | 是 | 问题的标题 | | description | string | 否 | 问题描述 |

示例用法

npm run list-issues -- --projectKey ABCD-001

或

npm run create-issue -- --projectKey ABCD-001 --title "功能未实现" --description "新功能未能按计划完成开发"

开发指南

项目结构

src/
├── services/       # Jira API 调用服务
│   └── jiraService.js    # 核心 API 调用逻辑
├── controllers/   # HTTP 请求处理层
│   └── issueController.js# 问题管理的路由和逻辑
└── models/        # 数据模型定义
    └── issueModel.js     # 问题数据结构定义

开发步骤

克隆项目仓库
安装依赖包
配置 Jira 凭据
启动开发服务器

贡献指南

欢迎社区贡献！请按照以下流程提交代码：

Fork 本仓库
创建功能分支
提交更改
提交 Pull Request

📄 许可证

本项目采用 MIT License。

jira-mcp-server