@abdelrahmanhsn/jira-mcp 1.0.1 → 1.3.0

package/README.md

@@ -9,6 +9,11 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that co
 | `get_my_tickets` | Get all Jira tickets assigned to you, ordered by last updated |
 | `get_active_sprint_tickets` | Get your tickets in the currently active sprint |
 | `get_issue_details` | Get full details (description + attachments) for a specific issue key |
+| `add_comment` | Add a comment to any Jira issue |
+| `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
 
@@ -116,6 +121,11 @@ Once configured, you can ask your AI assistant:
 - *"What's in my active sprint?"*
 - *"Get me the details for PROJ-1234"*
 - *"Summarize the description of PROJ-5678"*
+- *"Add a comment to PROJ-123 saying the fix is deployed to staging"*
+- *"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.0.1",
+  "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

@@ -80,6 +80,195 @@ server.tool(
   }
 );
 
+// Tool: add_comment
+server.tool(
+  "add_comment",
+  "Add a comment to a Jira issue",
+  {
+    issueKey: z.string().describe("The Jira issue key, e.g. PROJ-123"),
+    comment:  z.string().describe("The comment text to add"),
+  },
+  async ({ issueKey, comment }) => {
+    await jiraClient.post(`/issue/${issueKey}/comment`, {
+      body: {
+        type: "doc",
+        version: 1,
+        content: [{ type: "paragraph", content: [{ type: "text", text: comment }] }],
+      },
+    });
+    return { content: [{ type: "text", text: `Comment added to ${issueKey}.` }] };
+  }
+);
+
+// Tool: get_my_standup
+server.tool(
+  "get_my_standup",
+  "Get a standup summary: tickets you updated or commented on yesterday and today",
+  {},
+  async () => {
+    const yesterday = new Date();
+    yesterday.setDate(yesterday.getDate() - 1);
+    const since = yesterday.toISOString().split("T")[0]; // YYYY-MM-DD
+
+    const [updated, commented] = await Promise.all([
+      searchJira(
+        `assignee = currentUser() AND updated >= "${since}" ORDER BY updated DESC`,
+        "summary,status,priority,issuetype"
+      ),
+      searchJira(
+        `issueFunction in commented("by currentUser() after ${since}")`,
+        "summary,status,issuetype"
+      ).catch(() => []), // issueFunction requires ScriptRunner; gracefully skip if unavailable
+    ]);
+
+    const result = {
+      updated_tickets: updated,
+      commented_tickets: commented,
+      summary: `You updated ${updated.length} ticket(s) since ${since}.`,
+    };
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// Tool: get_sprint_summary
+server.tool(
+  "get_sprint_summary",
+  "Get a summary of all tickets in the active sprint grouped by status",
+  {},
+  async () => {
+    const issues = await searchJira(
+      `project = '${JIRA_PROJECT}' AND sprint IN openSprints()`,
+      "summary,status,priority,issuetype,assignee"
+    );
+
+    const grouped = issues.reduce((acc, issue) => {
+      const s = issue.status || "Unknown";
+      if (!acc[s]) acc[s] = [];
+      acc[s].push({ key: issue.key, summary: issue.summary, priority: issue.priority, type: issue.type });
+      return acc;
+    }, {});
+
+    const result = {
+      total: issues.length,
+      by_status: grouped,
+    };
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// Tool: search_tickets
+server.tool(
+  "search_tickets",
+  "Search Jira tickets using a plain-text query or a JQL string",
+  {
+    query: z.string().describe(
+      "Plain English query (e.g. 'open bugs assigned to me') or raw JQL (e.g. 'project = PROJ AND status = Open')"
+    ),
+    maxResults: z.number().optional().default(20).describe("Maximum number of results to return (default 20)"),
+  },
+  async ({ query, maxResults }) => {
+    // Use as raw JQL if it looks like JQL, otherwise wrap in a text search
+    const looksLikeJql = /\b(AND|OR|IN|=|!=|~|project|status|assignee|sprint|priority|issuetype)\b/i.test(query);
+    const jql = looksLikeJql
+      ? query
+      : `project = '${JIRA_PROJECT}' AND text ~ "${query.replace(/"/g, '\\"')}" ORDER BY updated DESC`;
+
+    const response = await jiraClient.get("/search/jql", {
+      params: { jql, fields: "summary,status,priority,issuetype,assignee,reporter", maxResults },
+    });
+
+    const issues = (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,
+      assignee: i.fields?.assignee?.displayName ?? "Unassigned",
+      reporter: i.fields?.reporter?.displayName,
+    }));
+
+    return { content: [{ type: "text", text: JSON.stringify(issues, null, 2) }] };
+  }
+);
+
+// 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);