Jira MCP Server R17

🚀 Jira Server

Jira Server is a powerful tool that simplifies Jira operations. It allows users to create, update, and retrieve issues efficiently through a series of APIs, and supports batch operations and custom configurations.

🚀 Quick Start

Installation and Configuration

1. Clone the repository

   git clone https://github.com/your-repository.git
   cd jira-server
   

2. Install dependencies

   npm install
   

3. Set environment variables

   • Create a .env file and add the following content:

     JIRA_HOST=Your Jira instance address
     JIRA_EMAIL=Your Jira email
     JIRA_API_TOKEN=Your Jira API token
     

4. Start the server

   npm start
   

✨ Features

Core Functions

• Create an issue

  {
    "issue": {
      "fields": {
        "summary": "Issue title",
        "description": "Issue description",
        "status": "Unsolved",
        "priority": "High priority",
        "assignee": { "id": "User ID" },
        "issuetype": { "id": "Issue type ID" }
      }
    }
  } 
  

• Update an issue

  {
    "issueKey": "Project-123",
    "fields": {
      "summary": "New title",
      "status": "Resolved"
    }
  }
  

📚 Documentation

Get the issue list

curl --user ${JIRA_EMAIL}:${JIRA_API_TOKEN} \
     --header "Content-Type: application/json" \
     --request GET \
     "https://${JIRA_HOST}/rest/api/2/search?jql=project%20=%22Project Name%22"

Get a single issue

curl --user ${JIRA_EMAIL}:${JIRA_API_TOKEN} \
     --header "Content-Type: application/json" \
     --request GET \
     "https://${JIRA_HOST}/rest/api/2/issue/Project-123"

Advanced Features

Batch Operations

Create multiple issues

{
  "issues": [
    {
      "fields": {
        "summary": "Issue 1",
        "description": "Description 1"
      }
    },
    {
      "fields": {
        "summary": "Issue 2",
        "description": "Description 2"
      }
    }
  ]
}

Update multiple issues

{
  "issueKeys": ["Project-123", "Project-124"],
  "fields": {
    "status": "Resolved"
  }
}

Custom Configuration

Custom Fields

Specify custom fields in the JIRA_CUSTOM_FIELDS environment variable:

JIRA_CUSTOM_FIELDS=summary,description,status,priority,assignee,issuetype

Request Example

Include custom fields when creating an issue

{
  "issue": {
    "fields": {
      "customfield_12345": "Custom value",
      "priority": { "id": "P1" }
    }
  }
}

Contribution Guidelines

Submit Code

1. Create a feature branch

   git checkout -b feature/new-feature
   

2. Commit changes

   git add .
   git commit -m "Add new feature"
   git push origin feature/new-feature
   

3. Submit a pull request

   • Visit GitHub repository
   • Click "New Pull Request"
   • Fill in the relevant information and submit

Code Style

• Follow the JavaScript standard
• Use meaningful variable names
• Focus on code readability

References

• Jira REST API: Official documentation
• Node.js: Official website
• npm: Package manager

📄 License

This project is licensed under the MIT License.
Copyright (c) 2023, Your Name.