Jira MCP Server

🚀 Jira Issue Tracking System Documentation

Jira is a widely-used project management tool for tracking and managing tasks, defects, and user stories in software development. This project aims to provide various functions for interacting with the Jira system, including creating and querying issues.

🚀 Quick Start

Jira is a project management tool commonly used to track and manage tasks, defects, and user stories in software development. This project offers multiple functions to interact with the Jira system, such as creating and querying issues.

✨ Features

1. Query Issues

List all issues in a specified project.

2. Create Issues

Create a new issue in a specified project.

📦 Installation

1. Get the Code

Clone the repository using Git:

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

2. Install Dependencies

Navigate to the project directory and install the required packages:

npm install

📚 Documentation

Configuration Instructions

Create a configuration file config.json with the following content:

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

Parameter Explanation

Development Guide

Project Structure

src/
├── services/       # Jira API call services
│   └── jiraService.js    # Core API call logic
├── controllers/   # HTTP request handling layer
│   └── issueController.js# Issue management routes and logic
└── models/        # Data model definitions
    └── issueModel.js     # Issue data structure definition

Development Steps

1. Clone the project repository.
2. Install the dependency packages.
3. Configure Jira credentials.
4. Start the development server.

Contribution Guide

Community contributions are welcome! Please follow these steps to submit your code:

1. Fork this repository.
2. Create a feature branch.
3. Commit your changes.
4. Submit a Pull Request.

💻 Usage Examples

Basic Usage

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

Advanced Usage

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

📄 License

MIT License