mcp-jira-stdio 1.6.1 → 1.7.1

package/README.md

@@ -338,6 +338,18 @@ jira_get_visible_projects({
 - Look for errors in Claude Desktop logs
 - Use `task inspector` to debug
 
+**Timeout when running multiple instances with npx**
+
+If you're running multiple Claude Code sessions simultaneously and experience timeouts, this is caused by `npx` cache/registry locking — not the MCP server itself. Each instance tries to verify the package, causing conflicts. To fix this, install the package globally instead:
+
+```bash
+npm install -g mcp-jira-stdio
+claude mcp add jira mcp-jira-stdio \
+  --env JIRA_BASE_URL=... \
+  --env JIRA_EMAIL=... \
+  --env JIRA_API_TOKEN=...
+```
+
 ### Debug Commands
 
 ```bash

package/dist/index.js

@@ -40,7 +40,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // node_modules/dotenv/package.json
 var require_package = __commonJS({
-  "node_modules/dotenv/package.json"(exports, module) {
+  "node_modules/dotenv/package.json"(exports$1, module) {
     module.exports = {
       name: "dotenv",
       version: "17.2.3",
@@ -108,7 +108,7 @@ var require_package = __commonJS({
 
 // node_modules/dotenv/lib/main.js
 var require_main = __commonJS({
-  "node_modules/dotenv/lib/main.js"(exports, module) {
+  "node_modules/dotenv/lib/main.js"(exports$1, module) {
     var fs = __require("fs");
     var path = __require("path");
     var os = __require("os");
@@ -437,10 +437,10 @@ var require_main = __commonJS({
 
 // package.json
 var require_package2 = __commonJS({
-  "package.json"(exports, module) {
+  "package.json"(exports$1, module) {
     module.exports = {
       name: "mcp-jira-stdio",
-      version: "1.6.1",
+      version: "1.7.1",
       description: "Model Context Protocol (MCP) server for Jira API integration",
       author: "graslt",
       license: "MIT",
@@ -486,29 +486,29 @@ var require_package2 = __commonJS({
         "ai"
       ],
       engines: {
-        node: ">=18.0.0"
+        node: ">=20.0.0"
       },
       dependencies: {
         "@modelcontextprotocol/sdk": "^1.17.1",
         axios: "^1.7.0",
-        "md-to-adf": "^0.6.4",
+        "md-to-adf": "^0.5.0",
         zod: "^3.22.4"
       },
       devDependencies: {
         "@types/node": "^22.5.0",
         "@typescript-eslint/eslint-plugin": "^8.0.0",
         "@typescript-eslint/parser": "^8.0.0",
-        "@vitest/coverage-v8": "^3.2.4",
-        "@vitest/ui": "^3.2.4",
+        "@vitest/coverage-v8": "^4.0.10",
+        "@vitest/ui": "^4.0.10",
         dotenv: "^17.2.1",
         eslint: "^9.9.0",
         "eslint-config-prettier": "^9.1.0",
         "eslint-plugin-prettier": "^5.2.0",
         prettier: "^3.5.0",
-        tsup: "^8.0.0",
+        tsup: "^8.5.1",
         tsx: "^4.16.0",
         typescript: "^5.5.0",
-        vitest: "^3.2.4"
+        vitest: "^4.0.10"
       },
       files: [
         "dist",
@@ -526,6 +526,10 @@ var require_package2 = __commonJS({
       homepage: "https://github.com/freema/mcp-jira-stdio#readme",
       publishConfig: {
         access: "public"
+      },
+      overrides: {
+        glob: ">=11.0.4",
+        marked: ">=4.0.10"
       }
     };
   }
@@ -560,7 +564,8 @@ var TOOL_NAMES = {
   CREATE_SUBTASK: "jira_create_subtask",
   GET_CREATE_META: "jira_get_create_meta",
   GET_CUSTOM_FIELDS: "jira_get_custom_fields",
-  CREATE_ISSUE_LINK: "jira_create_issue_link"
+  CREATE_ISSUE_LINK: "jira_create_issue_link",
+  GET_COMMENTS: "jira_get_comments"
 };
 
 // src/utils/logger.ts
@@ -844,6 +849,12 @@ var CreateIssueLinkInputSchema = z.object({
     'Link type: "blocks", "is blocked by", "relates", "duplicates", "clones", or custom link type name'
   )
 });
+var GetCommentsInputSchema = z.object({
+  issueKey: z.string().describe("Issue key to get comments for (e.g., PROJECT-123)").refine((v) => isValidIssueKey(v), "Invalid issue key format"),
+  maxResults: z.number().min(1).max(100).optional().describe("Maximum number of comments to return (default: 50)"),
+  orderBy: z.enum(["created", "-created", "+created"]).optional().describe('Sort order for comments: "created" (oldest first), "-created" (newest first)'),
+  startAt: z.number().min(0).optional().describe("Index of first comment to return (for pagination)")
+});
 function ensureAdfDescription(desc, format = "markdown") {
   if (!desc) return desc;
   if (typeof desc === "object") return desc;
@@ -1194,6 +1205,24 @@ async function addComment(issueKey, body, visibility, format) {
   };
   return await makeJiraRequest(config);
 }
+async function getComments(issueKey, options = {}) {
+  const params = {};
+  if (options.maxResults !== void 0) {
+    params.maxResults = options.maxResults;
+  }
+  if (options.orderBy !== void 0) {
+    params.orderBy = options.orderBy;
+  }
+  if (options.startAt !== void 0) {
+    params.startAt = options.startAt;
+  }
+  const config = {
+    method: "GET",
+    url: `/issue/${issueKey}/comment`,
+    params
+  };
+  return await makeJiraRequest(config);
+}
 async function getProjectDetails(projectKey, expand) {
   const params = {};
   if (expand) {
@@ -1627,6 +1656,44 @@ ${comment.body}`
     ]
   };
 }
+function formatCommentsResponse(response, issueKey) {
+  if (!response.comments || response.comments.length === 0) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `No comments found for issue ${issueKey}.`
+        }
+      ]
+    };
+  }
+  const commentsList = response.comments.map((comment) => {
+    const bodyText = typeof comment.body === "string" ? comment.body : adfToPlainText(comment.body);
+    const visibilityText = comment.visibility ? ` [${comment.visibility.type}: ${comment.visibility.value}]` : "";
+    const authorName = comment.author?.displayName || "Unknown";
+    const createdDate = comment.created ? new Date(comment.created).toISOString() : "N/A";
+    const updatedDate = comment.updated ? new Date(comment.updated).toISOString() : "N/A";
+    const wasEdited = comment.created !== comment.updated;
+    return `**${authorName}** - ${createdDate}${wasEdited ? ` (edited: ${updatedDate})` : ""}${visibilityText}
+${bodyText}`;
+  }).join("\n\n---\n\n");
+  const total = response.total;
+  const showingStart = response.startAt + 1;
+  const showingEnd = Math.min(response.startAt + response.comments.length, total);
+  const paginationInfo = total > response.comments.length ? `
+
+*Showing ${showingStart}-${showingEnd} of ${total} comments*` : "";
+  return {
+    content: [
+      {
+        type: "text",
+        text: `**Comments for ${issueKey}** (${response.comments.length} comment${response.comments.length !== 1 ? "s" : ""}):
+
+${commentsList}${paginationInfo}`
+      }
+    ]
+  };
+}
 function formatProjectDetailsResponse(project) {
   const leadText = project.lead ? `${project.lead.displayName} (${project.lead.accountId})` : "No lead assigned";
   const componentsText = project.components.length > 0 ? project.components.map((c) => c.name).join(", ") : "None";
@@ -2618,6 +2685,61 @@ async function handleCreateIssueLink(input) {
   }
 }
 
+// src/tools/get-comments.ts
+var log19 = createLogger("tool:get-comments");
+var getCommentsTool = {
+  name: TOOL_NAMES.GET_COMMENTS,
+  description: "Retrieves all comments for a Jira issue. Returns comment author, content, timestamps, and visibility settings. Supports pagination for issues with many comments.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      issueKey: {
+        type: "string",
+        description: "Issue key to get comments for (e.g., PROJECT-123)"
+      },
+      maxResults: {
+        type: "number",
+        description: "Maximum number of comments to return (default: 50, max: 100)",
+        minimum: 1,
+        maximum: 100
+      },
+      orderBy: {
+        type: "string",
+        enum: ["created", "-created", "+created"],
+        description: 'Sort order for comments: "created" or "+created" (oldest first), "-created" (newest first)'
+      },
+      startAt: {
+        type: "number",
+        description: "Index of first comment to return (for pagination, default: 0)",
+        minimum: 0
+      }
+    },
+    required: ["issueKey"]
+  }
+};
+async function handleGetComments(input) {
+  try {
+    const validated = validateInput(GetCommentsInputSchema, input);
+    log19.info(`Getting comments for issue ${validated.issueKey}...`);
+    const options = {};
+    if (validated.maxResults !== void 0) {
+      options.maxResults = validated.maxResults;
+    }
+    if (validated.orderBy !== void 0) {
+      options.orderBy = validated.orderBy;
+    }
+    if (validated.startAt !== void 0) {
+      options.startAt = validated.startAt;
+    }
+    const comments = await getComments(validated.issueKey, options);
+    log19.info(`Retrieved ${comments.comments.length} comment(s) for ${validated.issueKey}`);
+    return formatCommentsResponse(comments, validated.issueKey);
+  } catch (error) {
+    log19.error("Error in handleGetComments:", error);
+    return handleError(error);
+  }
+}
+
 // src/index.ts
 if (process.env.NODE_ENV !== "production") {
   try {
@@ -2626,7 +2748,7 @@ if (process.env.NODE_ENV !== "production") {
   } catch {
   }
 }
-var log19 = createLogger("server");
+var log20 = createLogger("server");
 var toolHandlers = /* @__PURE__ */ new Map([
   [TOOL_NAMES.GET_VISIBLE_PROJECTS, handleGetVisibleProjects],
   [TOOL_NAMES.GET_ISSUE, handleGetIssue],
@@ -2643,7 +2765,8 @@ var toolHandlers = /* @__PURE__ */ new Map([
   [TOOL_NAMES.CREATE_SUBTASK, handleCreateSubtask],
   [TOOL_NAMES.GET_CREATE_META, handleGetCreateMeta],
   [TOOL_NAMES.GET_CUSTOM_FIELDS, handleGetCustomFields],
-  [TOOL_NAMES.CREATE_ISSUE_LINK, handleCreateIssueLink]
+  [TOOL_NAMES.CREATE_ISSUE_LINK, handleCreateIssueLink],
+  [TOOL_NAMES.GET_COMMENTS, handleGetComments]
 ]);
 var allTools = [
   getVisibleProjectsTool,
@@ -2661,7 +2784,8 @@ var allTools = [
   createSubtaskTool,
   getCreateMetaTool,
   getCustomFieldsTool,
-  createIssueLinkTool
+  createIssueLinkTool,
+  getCommentsTool
 ];
 async function main() {
   const isDryRun = (process.env.DRY_RUN || "").toLowerCase() === "1" || (process.env.DRY_RUN || "").toLowerCase() === "true";
@@ -2732,7 +2856,7 @@ async function main() {
   console.error("\u{1F680} Jira MCP server running on stdio");
 }
 main().catch((error) => {
-  log19.error("Fatal error:", error);
+  log20.error("Fatal error:", error);
   process.exit(1);
 });
 //# sourceMappingURL=index.js.map