This MCP server provides a JIRA integration layer for VS Code using the Model Context Protocol. It enables natural language queries to be translated into JIRA REST API calls, allowing you to list projects, fetch issue details, search with JQL, and generate summaries or reports directly from your editor. The server runs as a Python module (mcp_jira) and reads credentials from environment variables set in a .env-like configuration you place alongside your project. Typical workflows involve starting the MCP server, then using the MCP-enabled VS Code extension to issue natural language commands that are contextualized against your JIRA instance. Supported capabilities include listing projects, querying issues by project or release, retrieving issue details, and generating Markdown summaries of issues for a given release or sprint. Make sure your JIRA URL and Personal Access Token are securely configured, and that SSL verification is set according to your environment.

Prerequisites:

• Python 3.8+ installed on your system
• Access to a JIRA Server/Data Center (not Atlassian Cloud) and a generated JIRA Personal Access Token
• Docker (optional, if you prefer containerized deployment)

Option 1 — Local development (recommended):

1. Clone the repository: git clone https://github.com/r-pedraza/mcp-jira-integration.git cd mcp-jira-integration

2. Create and activate a virtual environment: python -m venv venv

   macOS/Linux

   source venv/bin/activate

   Windows

   venv\Scripts\activate.bat

3. Install Python dependencies: pip install -r requirements.txt

4. Configure environment variables (create a .env file or export variables in your shell): export JIRA_URL=https://your-jira-server.com export JIRA_PERSONAL_TOKEN=your_token_here export JIRA_SSL_VERIFY=false

5. Run the MCP Jira integration server: python -m mcp_jira

Option 2 — Docker (containerized):

1. Build/run using Docker (adjust image as needed): docker build -t mcp-jira-integration . docker run -i --env JIRA_URL=https://your-jira-server.com --env JIRA_PERSONAL_TOKEN=your_token_here --env JIRA_SSL_VERIFY=false mcp-jira-integration

Note: If you use Docker, you may want to mount a local configuration file or pass environment variables at runtime depending on your deployment preferences.

Tips and common issues:

• Ensure your JIRA Personal Access Token has at least read permissions for the operations you plan to perform.
• If you encounter SSL issues with a self-signed certificate, set JIRA_SSL_VERIFY=false, but be aware of the security implications in production.
• The MCP config expects the module to be importable as mcp_jira; ensure your PYTHONPATH or working directory includes the repository root when running from a script or VS Code integration.
• If starting via Docker, consider mapping a local .env file for easier management of credentials.
• The VS Code MCP configuration file (.vscode/mcp.json) will be generated by the project setup; ensure it points to the running MCP server and includes authentication context for your Jira instance.