jiramcpserver

Jira MCP Server

This is a simple prototype of a Jira Server/DC MCP server.

It uses Python APIs for Jira documented here, and the MCP Python SDK.

Run steps

1. Copy .env.example to .env, and replace ```YOUR_JIRA_HOST_URL``` and ```YOUR_JIRA_PERSONAL_ACCESS_TOKEN```. The Jira host url must belong to a Jira server/ DC (the project is intended for Jira server/ DC). To generate your Personal Access Token, refer the section 'Creating PATs in the application' here.

2. Create and activate virtual environment, and install dependencies - ```pip install -r requirements.txt```

3. Run ```mcp dev jira_mcp_server.py``` - this runs MCP Inspector which is a local way to test the defined tools and responses without involving an LLM.

MCP Integration

The server can be started using ```python jira_mcp_server.py```.

1. With Claude Desktop - Add to your claude_desktop_config.json the command and args :

{
  "mcpServers": {
    "jira": {
      "command": "/Users/harshal.mittal/.pyenv/versions/3.10.0/bin/python",
      "args": [
        "/Users/harshal.mittal/projects/jira-mcp-server/jira_mcp_server.py"
      ]
    }
  }
}

Include the full paths of the python binary and the jira_mcp_server.py file on your system (reference).

2. With Other MCP Clients - The server follows the standard MCP protocol and works with any MCP-compatible client.

Project Structure

JiraMCPserver/
├── jira_client/
│   ├── __init__.py
│   │── client.py
|   |── issue.py
|   └── project.py
├── models/
│   ├── __init__.py
│   │── constants.py
|   └── issue.py
├── jira_mcp_server.py
├── .env.example
├── .gitignore
└── requirements.txt

Supported operations -

This currently supports read-only issue and project management tools, for example

• "Give me all issues which are related to Recovery and open for more than 90 days"
• "List all issues assigned to Harshal Mittal resolved in last 30 days"
• "Find count of all open issues in ENG project"

Tools for write/ updating Jira can be added in similar way.