JiraMCP

A production-ready Model Context Protocol (MCP) server that integrates with Jira Cloud and exposes tools usable by GitHub Copilot Chat, JetBrains AI Assistant, and any other MCP-compatible client.

---

| Tool | Description | |---|---| | get_jira_issue | Fetch a single issue by key (e.g. PROJ-123) | | search_jira_issues | Search issues using JQL | | add_jira_comment | Add a comment to an existing issue |

Built-in reliability:

• ✅ In-memory cache with 60 s TTL (GET & search requests)
• ✅ Automatic retry with exponential back-off (up to 3 attempts)
• ✅ Rate-limit handling — respects Retry-After header on HTTP 429
• ✅ Input validation via Zod schemas
• ✅ Structured JSON responses (no raw Jira payloads)
• ✅ Graceful error handling with meaningful messages

---

| Requirement | Minimum Version | |---|---| | Node.js | ≥ 18 LTS | | npm | ≥ 9 | | Git | any recent version | | Jira Cloud instance | REST API v3 (/rest/api/3) |

> ⚠️ Jira Server / Data Center may work but is not officially tested. This server targets Jira Cloud REST API v3.

---

1. Log in to your Atlassian account
2. Go to → <https://id.atlassian.com/manage-profile/security/api-tokens>
3. Click Create API token
4. Give it a label (e.g. _"MCP Server"_) and click Create
5. Copy the token immediately — you won't be able to see it again

> 💡 The token is tied to your Atlassian email. You will need both the email and the token for authentication.

---

# Clone the repository
git clone https://github.com/<your-org>/JiraMCP.git
cd JiraMCP

# Install dependencies
npm install

| Package | Purpose | |---|---| | @modelcontextprotocol/sdk | MCP server framework | | axios | HTTP client for Jira REST API | | dotenv | Loads .env config | | zod | Input schema validation | | typescript | Build to