Skip to main content
Prerequisites: - Python 3.11 or higher - UV package manager - jira-cli installed and configured

​
Getting started

Clone the repository and set up your development environment:

​
Pre-commit hooks

This project uses pre-commit to run ruff linting and formatting checks, and pytest tests before each commit.
1

Install pre-commit hooks

2

Run checks manually

Once installed, ruff and pytest will automatically run when you commit. To run checks manually on all files:

​
Logging

Do not use print statements for logging. Use the logging module instead. Writing to stdout will corrupt the JSON-RPC messages and break your server.

​
Docstrings and tool decorators

MCP tools decorator parameters are especially important as this is the human-readable text that the LLM has context of. This will be treated as part of the prompt when fed to the LLM and this will decide when to use each tool.

​
Troubleshooting

On macOS:
If you get a 404 error when using jira init, you may need to edit the jira-cli config file to point to the correct Jira instance.There are only 3 possible values for the auth type, so try each one:
  • basic
  • password
  • bearer