1broseidon MCP Jira Server

🚀 Jira MCP Server

A Model Context Protocol (MCP) server integrated with the Jira REST API, enabling AI assistants to programmatically manage Jira issues.

✨ Features

This server offers tools for managing Jira issues:

• Create new issues (tasks, epics, subtasks)
• List issues with optional status filtering
• Update existing issues (title, description, status)
• Get detailed issue information
• Delete issues
• Add comments to issues

📦 Installation

Prerequisites

1. A Jira account with API access privileges.
2. A Jira API token, which can be generated at Atlassian Account Settings.

Installation Steps

1. Install dependencies:

npm install

2. Build the server:

npm run build

Configuration

1. Create a .jira-config.json file in the working directory:

{
  "projectKey": "YOUR_PROJECT_KEY"
}

2. Configure the Jira credentials for the MCP server:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On 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": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

💻 Usage Examples

create_issue

Create a new Jira issue.

• Required parameters:
  • working_dir: The directory containing .jira-config.json.
  • summary: The issue title.
  • description: The issue description.
  • type: The issue type (task, epic, or subtask).

list_issues

List issues in the project.

• Required parameters:
  • working_dir: The directory containing .jira-config.json.
• Optional parameters:
  • status: Filter by status (e.g., "To Do", "In Progress", "Done").

update_issue

Update an existing issue.

• Required parameters:
  • working_dir: The directory containing .jira-config.json.
  • issue_key: The issue key (e.g., PRJ-123).
• Optional parameters:
  • summary: The new title.
  • description: The new description.
  • status: The new status.

get_issue

Get detailed information about a specific issue.

• Required parameters:
  • working_dir: The directory containing .jira-config.json.
  • issue_key: The issue key (e.g., PRJ-123).

delete_issue

Delete a Jira issue.

• Required parameters:
  • working_dir: The directory containing .jira-config.json.
  • issue_key: The issue key (e.g., PRJ-123).

add_comment

Add a comment to an existing issue.

• Required parameters:
  • working_dir: The directory containing .jira-config.json.
  • issue_key: The issue key (e.g., PRJ-123).
  • comment: The comment text to be added.

🔧 Technical Details

Development

For development with automatic rebuild:

npm run watch

Error Handling

This server includes comprehensive error handling features, covering:

• Invalid project keys
• Missing configuration files
• Invalid issue types
• API authentication errors
• Invalid status transitions

Output Format

Issue information is displayed in the following format:

• Issue key and title
• Issue type and status
• Creation date and creator
• Description
• Comments (if any), along with their authors and timestamps