https://github.com/KS-GEN-AI/jira-mcp-server
A test of jira mcp server
https://github.com/KS-GEN-AI/jira-mcp-server
Last synced: 3 months ago
JSON representation
A test of jira mcp server
- Host: GitHub
- URL: https://github.com/KS-GEN-AI/jira-mcp-server
- Owner: KS-GEN-AI
- Created: 2024-12-12T08:51:16.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-02-05T14:42:24.000Z (5 months ago)
- Last Synced: 2025-02-05T15:43:43.304Z (5 months ago)
- Language: JavaScript
- Size: 31.3 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - Jira MCP Server - An MCP Server for accessing Jira data via JQL and API, including creating and editing tickets. Enables AI assistants to interact with Jira using the MCP protocol. ([Read more](/details/jira-mcp-server.md)) `mcp` `jira` `project-management` `ai-integration` (Project Management MCP Servers)
- awesome-mcp-zh - KS-GEN-AI/jira-mcp-server
- awesome-mcp-servers - KS-GEN-AI/jira-mcp-server - Read jira data via JQL and api and execute requests to create and edit tickets. (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - KS-GEN-AI/jira-mcp-server - Read jira data via JQL and api and execute requests to create and edit tickets. (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - Jira MCP Client - A test of jira mcp server (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - Jira MCP Client - A test of jira mcp server (Table of Contents / Other Tools and Integrations)
- mcp-index - Jira communication server MCP Server - Interact with Jira to execute JQL queries, manage Jira tickets, and retrieve project statuses. Provides functionality to create, edit, and delete tickets as well as fetch ticket details. (Task and Project Management)
README
# Jira communication server MCP Server
Talk to Jira
This is a TypeScript-based MCP server that provides tools to interact with Jira. It demonstrates core MCP concepts by providing:
- Tools for executing JQL queries
- Tools for creating, editing, and deleting Jira tickets
- Tools for listing Jira projects and statuses
## Features
## Jira Tools
### `execute_jql`
- **Purpose**: Run a JQL query.
- **Parameters**: `jql`, `number_of_results` (default: 1).
### `get_only_ticket_name_and_description`
- **Purpose**: Fetch ticket name and description.
- **Parameters**: `jql`, `number_of_results` (default: 1).
### `create_ticket`
- **Purpose**: Create a Jira ticket.
- **Parameters**: `project.key`, `summary`, `description`, `issuetype.name`, `parent` (optional).
### `list_projects`
- **Purpose**: List Jira projects.
- **Parameters**: `number_of_results` (default: 1).
### `delete_ticket`
- **Purpose**: Delete a ticket.
- **Parameters**: `issueIdOrKey`.
### `edit_ticket`
- **Purpose**: Modify a ticket.
- **Parameters**: `issueIdOrKey`, `summary` (optional), `description` (optional), `labels` (optional), `parent` (optional).
### `get_all_statuses`
- **Purpose**: Retrieve all statuses.
- **Parameters**: `number_of_results` (default: 1).
### `assign_ticket`
- **Purpose**: Assign a ticket to a user.
- **Parameters**: `accountId`, `issueIdOrKey`.
### `query_assignable`
- **Purpose**: Find assignable users in a project.
- **Parameters**: `project_key`.
### `add_attachment`
- **Purpose**: Add an attachment to a ticket.
- **Parameters**: `issueIdOrKey`, `imageUrl`.
## Development
Install dependencies:
```bash
npm install
```
Build the server:
```bash
npm run build
```
For development with auto-rebuild:
```bash
npm run watch
```
## Installation
To use with Claude Desktop, add the server config:
On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"Jira communication server": {
"command": "node",
"args": [
"/PATH_TO_THE_PROJECT/build/index.js"
],
"env": {
"JIRA_URL": "https://XXXXXXXX.atlassian.net",
"JIRA_API_MAIL": "Your email",
"JIRA_API_KEY": "KEY_FROM : https://id.atlassian.com/manage-profile/security/api-tokens"
}
}
}
}
```
### Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:
```bash
npm run inspector
```
The Inspector will provide a URL to access debugging tools in your browser.