Integrations
Enables configuration through environment variables stored in .env files for local development, supporting settings like DEBUG and LOG_FILE_PATH.
Supports testing the MCP server codebase through Jest's testing framework, accessible via npm test command.
Provides tools for interacting with Jira, including fetching and analyzing issues, running JQL queries, and a step-by-step wizard for creating new issues with support for project selection, issue type configuration, and field management.
Jira MCP Server
A collection of tools designed for interacting with Jira via the Model Context Protocol (MCP), providing core Jira functionalities and a unified, guided Issue Creation and Update Wizard.
Installation
To install this into a client:
Usage
...
Configuration
Environment Variables
For running locally, you can put the DEBUG and LOG_FILE_PATH into your .env.
Available Tools
This application exposes the following tools via the Model Context Protocol:
Core Jira Tools
getJiraIssue
: Fetches a Jira issue by its key.analyzeJiraIssue
: Performs comprehensive analysis of a Jira issue.jiraGet
: Fetches data from any Jira API GET endpoint.getIssuesByJql
: Searches for Jira issues using a JQL query.
Issue Creation Wizard Tools
These tools provide a step-by-step, guided process for creating new Jira issues. The wizard maintains state throughout the creation flow, typically involving these stages: initiating the process, selecting a project (getProjects
), choosing an issue type (getIssueTypes
), retrieving and populating the necessary fields (getFields
, updateFields
), optionally analyzing the issue details, and finally confirming and creating the issue (createIssue
). Use getState
and getStatus
to monitor progress, and resetState
to start over.
issueCreation_getState
: Gets the current internal state of the wizard.issueCreation_getStatus
: Gets the high-level status of the wizard.issueCreation_initiateState
: Initializes a new wizard state.issueCreation_resetState
: Resets the wizard state.issueCreation_updateState
: Updates the wizard state (project, issue type, fields, step).issueCreation_createIssue
: Creates a Jira issue using the wizard's state.issueCreation_getProjects
: Retrieves available Jira projects.issueCreation_getIssueTypes
: Gets available issue types for the selected project.issueCreation_getFields
: Retrieves fields required for the selected project/issue type.issueCreation_updateFields
: Updates specific field values in the wizard state.issueCreation_setAnalysisComplete
: Sets the analysis complete flag.issueCreation_setUserConfirmation
: Sets the user confirmation flag before creation.issueCreation_analyzeIssue
: Analyzes the issue details within the wizard context.
Issue Update Wizard Tools (Unified Update Workflow)
These tools provide a unified, robust mechanism for updating any Jira issue—whether newly created or already existing. All updates now use a single, consistent workflow:
issueUpdateWizard_loadIssueIntoState
: Fetch a Jira issue by key and load it into the state manager for unified update workflows.issueUpdateWizard_updateIssueFromState
: Update any loaded issue using the current state (fields, project, type, etc.).
Key Principles:
- All issue updates (new or existing) follow the same pattern: load the issue into state, modify fields, and update via the API.
- No code duplication between new and existing issue updates.
- Minimal, explicit, and robust error handling.
- 100% unit test coverage for update operations.
Development
Running Tests
Jest is configured for testing. To run the test suite:
Code Quality Checks
To run type checking, linting, and tests together:
Running with MCP Inspector
For local development and testing using the Model Context Protocol Inspector, you can launch the application and pass the required environment variables using the -e
flag:
(Ensure you have built the project first if using build/index.js
)
License
This project is licensed under the MIT License - see the LICENSE
file for details.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A collection of tools for interacting with Jira via the Model Context Protocol, providing core functionalities like fetching and analyzing issues, plus a guided Issue Creation Wizard.
Related MCP Servers
- AsecurityAlicenseAqualityProvides an interface to access and manage JIRA data through the Model Context Protocol, offering features like relationship tracking, data cleaning, and contextual insights for AI applications.Last updated -912718TypeScriptMIT License
- -securityFlicense-qualityA server implementation that allows AI models to interact with Jira through the Model Context Protocol, enabling tasks like JQL searches and retrieving issue details.Last updated -Python
- AsecurityFlicenseAqualityA Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.Last updated -32Python
- AsecurityAlicenseAqualityA Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.Last updated -5872TypeScriptMIT License