jira-mcp-server is a TypeScript-based MCP server used to interact with Jira. According to the project materials, it demonstrates core MCP concepts by providing a series of tools, and serves as a test project for the jira mcp server.
Main capabilities
The tools provided by this server, along with their purposes and parameters, are as follows:
- Execute JQL query: the purpose is to run a JQL query; the parameters are jql, number_of_results (default: 1).
- get_only_ticket_name_and_description: the purpose is to get the ticket name and description.
- Create Jira ticket: the parameters are project.key, summary, description, issuetype.name, parent (optional).
- List Jira projects: the parameter is number_of_results (default: 1).
- Delete ticket: the parameter is issueIdOrKey.
- Modify ticket: the parameters are issueIdOrKey, summary (optional), description (optional), labels (optional), parent (optional).
- get_all_statuses: the purpose is to retrieve all statuses.
- Assign ticket to user: the parameters are accountId, issueIdOrKey.
- query_assignable: the purpose is to find assignable users in a project; the parameter is project_key.
- add_attachment_from_public_url: the purpose is to add an attachment to a ticket from a public URL; the parameters are issueIdOrKey, imageUrl.
- add_attachment_from_confluence: the purpose is to add an attachment to a ticket from a Confluence page; the parameters are issueIdOrKey, pageId, attachmentName.
Usage
The project is TypeScript code. Before use, dependencies need to be installed and the server built. The materials provide the following steps:
- Install dependencies: npm install
- Build the server: npm run build
- Use automatic rebuild during development: npm run watch
To use with Claude Desktop, a server configuration needs to be added. The configuration file locations are:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
Because MCP servers communicate via stdio, debugging can be challenging. The project recommends using MCP Inspector, which is provided as a package script and will provide a URL for accessing the debugging tool in a browser.
Applicable scenarios and limitations
This project is positioned as a test-oriented jira mcp server, suitable for understanding or verifying the integration capabilities between MCP and Jira, such as querying data via JQL, creating and editing tickets, and similar scenarios. The materials do not provide explanations regarding formal production use, authorization and authentication, security, performance, or pricing; specific MCP configuration content, dependency names and versions, debugging script names, and the Jira API version are not provided at this time.
