@abdelrahmanhsn/jira-mcp 1.2.0 → 1.3.0

package/README.md

@@ -13,6 +13,7 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that co
 | `get_my_standup` | Get a standup summary of tickets you updated since yesterday |
 | `get_sprint_summary` | Get all sprint tickets grouped by status (Todo / In Progress / Done) |
 | `search_tickets` | Search tickets with plain English or raw JQL |
+| `get_context_for_pr` | Extract Jira ticket from a branch name and return a ready-to-use PR description block |
 
 ## Prerequisites
 
@@ -124,6 +125,7 @@ Once configured, you can ask your AI assistant:
 - *"Give me my standup for today"*
 - *"Summarize the active sprint — how many tickets are done vs in progress?"*
 - *"Search for open bugs related to login"*
+- *"Get PR context for branch STUD-17891-add-email-icon"*
 
 ## Security
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@abdelrahmanhsn/jira-mcp",
   "type": "module",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP server for Jira — query your tickets, active sprints, and issue details from any AI IDE (GitHub Copilot, Cursor, Claude Desktop)",
   "main": "server.js",
   "bin": {

package/server.js

@@ -191,6 +191,84 @@ server.tool(
   }
 );
 
+// Tool: get_context_for_pr
+server.tool(
+  "get_context_for_pr",
+  "Extract the Jira ticket key from a branch name, fetch its details and comments, and return a structured PR context block ready for AI to write a pull request description",
+  {
+    branch: z.string().describe("Git branch name, e.g. STUD-17891-add-email-icon or feature/STUD-17891"),
+  },
+  async ({ branch }) => {
+    // Extract issue key (e.g. STUD-17891) from anywhere in the branch name
+    const match = branch.match(/([A-Z][A-Z0-9]+-\d+)/i);
+    if (!match) {
+      return {
+        content: [{
+          type: "text",
+          text: `Could not find a Jira issue key in branch name: "${branch}". Expected format: PROJ-123 anywhere in the branch.`,
+        }],
+      };
+    }
+
+    const issueKey = match[1].toUpperCase();
+
+    const [issueRes, commentsRes] = await Promise.all([
+      jiraClient.get(`/issue/${issueKey}`, {
+        params: { fields: "summary,description,issuetype,priority,status,assignee,reporter,labels,components" },
+      }),
+      jiraClient.get(`/issue/${issueKey}/comment`, {
+        params: { maxResults: 10, orderBy: "-created" },
+      }),
+    ]);
+
+    const f = issueRes.data.fields;
+
+    // Extract plain text from Atlassian Document Format description
+    function extractText(node) {
+      if (!node) return "";
+      if (node.type === "text") return node.text || "";
+      if (node.content) return node.content.map(extractText).join(" ");
+      return "";
+    }
+
+    const description = extractText(f.description).trim() || "No description provided.";
+
+    const comments = (commentsRes.data.comments || []).map(c => ({
+      author: c.author?.displayName,
+      body: extractText(c.body).trim(),
+      created: c.created?.split("T")[0],
+    })).filter(c => c.body);
+
+    const context = {
+      issue_key: issueKey,
+      summary: f.summary,
+      type: f.issuetype?.name,
+      priority: f.priority?.name,
+      status: f.status?.name,
+      assignee: f.assignee?.displayName ?? "Unassigned",
+      reporter: f.reporter?.displayName,
+      labels: f.labels ?? [],
+      components: (f.components ?? []).map(c => c.name),
+      description,
+      recent_comments: comments,
+      pr_context: [
+        `## ${issueKey}: ${f.summary}`,
+        ``,
+        `**Type:** ${f.issuetype?.name} | **Priority:** ${f.priority?.name} | **Status:** ${f.status?.name}`,
+        ``,
+        `### What this PR does`,
+        description,
+        comments.length > 0 ? `\n### Discussion context\n${comments.map(c => `- **${c.author}** (${c.created}): ${c.body}`).join("\n")}` : "",
+        ``,
+        `### Jira ticket`,
+        `https://${JIRA_DOMAIN}/browse/${issueKey}`,
+      ].filter(Boolean).join("\n"),
+    };
+
+    return { content: [{ type: "text", text: JSON.stringify(context, null, 2) }] };
+  }
+);
+
 // ── Start ────────────────────────────────────────────────────────────────────
 const transport = new StdioServerTransport();
 await server.connect(transport);