mcp-jira

This MCP server provides a Jira-integrated interface for managing issues directly from the MCP platform. You can create, read, update, and search Jira issues, manage epics and their subtasks, and track personal issues. It also supports creating Jira issues from product requirements or PRDs. To use it, start the Python server as described in the setup, then interact with the exposed endpoints to perform common Jira actions without leaving the MCP environment. The server reads configuration from your .env file (JIRA_SERVER, JIRA_USER, JIRA_TOKEN, etc.) and exposes endpoints for issue manipulation, search, and epic/subtask management, enabling you to streamline issue tracking alongside other MCP capabilities.

Prerequisites:

• Python 3.8+
• Jira account with API access
• Jira API token

Step-by-step installation:

1. Clone the repository: git clone <repository-url>\n2) Create and activate a virtual environment: python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
2. Install dependencies: pip install -r requirements.txt
3. Copy the example environment file and fill in Jira credentials: cp .env.example .env
4. Edit .env to configure Jira and server settings:
   • JIRA_SERVER: Your Jira instance URL
   • JIRA_USER: Your Jira email
   • JIRA_TOKEN: Your Jira API token
   • JIRA_TIMEOUT: API timeout in seconds (default: 30)
   • JIRA_MAX_RESULTS: Maximum results per page (default: 50)
   • MCP_SERVER_PORT: Server port (default: 8000)
5. Run the server: python src/main.py
6. Access the server at: http://localhost:8000

Tips and notes:

• Never commit your .env file; keep credentials secure.
• Ensure your Jira API token is kept confidential and rotate as needed.
• In production, use HTTPS and consider additional authentication for the API endpoints.
• A static folder inside src is required by the server as indicated in the setup notes.
• If you encounter connection issues, verify JIRA_SERVER accessibility and that the token has the required scopes.