@abdelrahmanhsn/jira-mcp 1.0.0

package/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "snyk.advanced.autoSelectOrganization": true
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@abdelrahmanhsn/jira-mcp",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "MCP server for Jira — query tickets, sprints, and issue details from any AI IDE",
+  "main": "server.js",
+  "bin": {
+    "jira-mcp": "./server.js"
+  },
+  "scripts": {
+    "start": "node server.js"
+  },
+  "keywords": ["mcp", "jira", "atlassian", "model-context-protocol", "ai"],
+  "author": "Abdelrahman Hassan",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "axios": "^1.15.1"
+  }
+}

package/server.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import axios from "axios";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// ── Jira credentials (injected by MCP client via env) ──────────────────────
+const JIRA_EMAIL  = process.env.JIRA_EMAIL;
+const JIRA_TOKEN  = process.env.JIRA_TOKEN;
+const JIRA_DOMAIN = process.env.JIRA_DOMAIN;
+
+const missing = ["JIRA_EMAIL", "JIRA_TOKEN", "JIRA_DOMAIN"].filter(k => !process.env[k]);
+if (missing.length) {
+  process.stderr.write(
+    `[jira-mcp] Missing required environment variables: ${missing.join(", ")}\n` +
+    `Set them in your MCP client config under the "env" key.\n`
+  );
+  process.exit(1);
+}
+
+const jiraClient = axios.create({
+  baseURL: `https://${JIRA_DOMAIN}/rest/api/3`,
+  auth: { username: JIRA_EMAIL, password: JIRA_TOKEN },
+});
+
+// ── Helper ───────────────────────────────────────────────────────────────────
+async function searchJira(jql, fields = "summary,status,priority,description,issuetype,attachment,reporter") {
+  const response = await jiraClient.get("/search/jql", { params: { jql, fields } });
+  return (response.data.issues || []).map(i => ({
+    key: i.key,
+    summary: i.fields?.summary,
+    status: i.fields?.status?.name,
+    priority: i.fields?.priority?.name,
+    type: i.fields?.issuetype?.name,
+    reporter: i.fields?.reporter?.displayName,
+    description: JSON.stringify(i.fields?.description),
+    attachments: (i.fields?.attachment || []).map(a => a.content),
+  }));
+}
+
+// ── MCP Server ───────────────────────────────────────────────────────────────
+const server = new McpServer({
+  name: "jira-mcp",
+  version: "1.0.0",
+});
+
+// Tool: get_my_tickets
+server.tool(
+  "get_my_tickets",
+  "Get all Jira tickets assigned to the current user",
+  {},
+  async () => {
+    const result = await searchJira("assignee = currentUser() ORDER BY updated DESC");
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// Tool: get_active_sprint_tickets
+server.tool(
+  "get_active_sprint_tickets",
+  "Get user tickets in the active sprint of the Core Team board (STUD project)",
+  {},
+  async () => {
+    const result = await searchJira(
+      "project = 'STUD' AND sprint IN openSprints() AND assignee = currentUser()"
+    );
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// Tool: get_issue_details
+server.tool(
+  "get_issue_details",
+  "Get full details (description + attachments) for a specific Jira issue",
+  { issueKey: z.string().describe("The Jira issue key, e.g. STUD-17797") },
+  async ({ issueKey }) => {
+    const response = await jiraClient.get(`/issue/${issueKey}`);
+    return { content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }] };
+  }
+);
+
+// ── Start ────────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);