@abdelrahmanhsn/jira-mcp 1.0.1 → 1.2.0

package/README.md

@@ -9,6 +9,10 @@ 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 |
 
 ## Prerequisites
 
@@ -116,6 +120,10 @@ 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"*
 
 ## Security
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@abdelrahmanhsn/jira-mcp",
   "type": "module",
-  "version": "1.0.1",
+  "version": "1.2.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,117 @@ 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) }] };
+  }
+);
+
 // ── Start ────────────────────────────────────────────────────────────────────
 const transport = new StdioServerTransport();
 await server.connect(transport);