mcp-jira-stdio 1.6.0 → 1.6.1

package/dist/index.js

@@ -440,7 +440,7 @@ var require_package2 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "mcp-jira-stdio",
-      version: "1.6.0",
+      version: "1.6.1",
       description: "Model Context Protocol (MCP) server for Jira API integration",
       author: "graslt",
       license: "MIT",
@@ -559,7 +559,8 @@ var TOOL_NAMES = {
   GET_PROJECT_INFO: "jira_get_project_info",
   CREATE_SUBTASK: "jira_create_subtask",
   GET_CREATE_META: "jira_get_create_meta",
-  GET_CUSTOM_FIELDS: "jira_get_custom_fields"
+  GET_CUSTOM_FIELDS: "jira_get_custom_fields",
+  CREATE_ISSUE_LINK: "jira_create_issue_link"
 };
 
 // src/utils/logger.ts
@@ -836,6 +837,13 @@ var GetCreateMetaInputSchema = z.object({
 var GetCustomFieldsInputSchema = z.object({
   projectKey: z.string().optional().describe("Project key to filter custom fields (optional)").refine((v) => v ? isValidProjectKey(v) : true, "Invalid project key format")
 });
+var CreateIssueLinkInputSchema = z.object({
+  fromIssue: z.string().describe("Source issue key").refine((v) => isValidIssueKey(v), "Invalid issue key format"),
+  toIssue: z.string().describe("Target issue key").refine((v) => isValidIssueKey(v), "Invalid issue key format"),
+  linkType: z.string().describe(
+    'Link type: "blocks", "is blocked by", "relates", "duplicates", "clones", or custom link type name'
+  )
+});
 function ensureAdfDescription(desc, format = "markdown") {
   if (!desc) return desc;
   if (typeof desc === "object") return desc;
@@ -1016,8 +1024,8 @@ async function searchIssues(options) {
   if (options.fields) {
     data.fields = options.fields;
   }
-  if (options.expand) {
-    data.expand = options.expand;
+  if (options.expand && options.expand.length > 0) {
+    data.expand = options.expand.join(",");
   }
   const config = {
     method: "POST",
@@ -1263,6 +1271,40 @@ async function getFields() {
   };
   return await makeJiraRequest(config);
 }
+async function createIssueLink(fromIssue, toIssue, linkType) {
+  const linkTypeMap = {
+    blocks: "Blocks",
+    "is blocked by": "Blocks",
+    relates: "Relates",
+    "relates to": "Relates",
+    duplicates: "Duplicate",
+    duplicate: "Duplicate",
+    "is duplicated by": "Duplicate",
+    clones: "Cloners",
+    "is cloned by": "Cloners"
+  };
+  const normalizedLinkType = linkType.toLowerCase();
+  const jiraLinkType = linkTypeMap[normalizedLinkType] || linkType;
+  const isInward = normalizedLinkType === "is blocked by" || normalizedLinkType === "is duplicated by" || normalizedLinkType === "is cloned by";
+  const data = {
+    type: {
+      name: jiraLinkType
+    }
+  };
+  if (isInward) {
+    data.inwardIssue = { key: fromIssue };
+    data.outwardIssue = { key: toIssue };
+  } else {
+    data.outwardIssue = { key: fromIssue };
+    data.inwardIssue = { key: toIssue };
+  }
+  const config = {
+    method: "POST",
+    url: "/issueLink",
+    data
+  };
+  await makeJiraRequest(config);
+}
 
 // src/utils/redaction.ts
 function isRedactionEnabled() {
@@ -1392,14 +1434,15 @@ function formatSearchResultsResponse(result) {
     return `\u2022 **${issue.key}** - ${summary}
   Status: ${status} | Assignee: ${assignee} | Priority: ${priority}`;
   }).join("\n\n");
+  const total = result.total ?? result.issues.length;
   const rangeStart = result.startAt + 1;
-  const rangeEnd = Math.min(result.startAt + result.maxResults, result.total);
-  const showRangeInline = result.total > result.maxResults || result.startAt > 0;
+  const rangeEnd = Math.min(result.startAt + result.maxResults, total);
+  const showRangeInline = total > result.maxResults || result.startAt > 0;
   let paginationInfo = "";
   if (showRangeInline) {
     paginationInfo = `
 
-*Showing ${rangeStart}-${rangeEnd} of ${result.total} results*`;
+*Showing ${rangeStart}-${rangeEnd} of ${total} results*`;
   }
   if (result.nextPageToken && !result.isLast) {
     paginationInfo += `
@@ -1411,7 +1454,7 @@ function formatSearchResultsResponse(result) {
     content: [
       {
         type: "text",
-        text: `Found ${result.total} issue(s)${showRangeInline ? ` (showing ${rangeStart}-${rangeEnd})` : ""}:
+        text: `Found ${total} issue(s)${showRangeInline ? ` (showing ${rangeStart}-${rangeEnd})` : ""}:
 
 ${issuesList}${paginationInfo}`
       }
@@ -1888,7 +1931,7 @@ async function handleSearchIssues(input) {
     if (validated.fields !== void 0) searchParams.fields = validated.fields;
     if (validated.expand !== void 0) searchParams.expand = validated.expand;
     const result = await searchIssues(searchParams);
-    log5.info(`Found ${result.total} issue(s), showing ${result.issues.length}`);
+    log5.info(`Found ${result.total ?? 0} issue(s), showing ${result.issues.length}`);
     return formatSearchResultsResponse(result);
   } catch (error) {
     log5.error("Error in handleSearchIssues:", error);
@@ -1940,7 +1983,9 @@ async function handleGetMyIssues(input) {
     if (validated.fields !== void 0) getParams.fields = validated.fields;
     if (validated.expand !== void 0) getParams.expand = validated.expand;
     const result = await getMyIssues(getParams);
-    log6.info(`Found ${result.total} issue(s) assigned to you, showing ${result.issues.length}`);
+    log6.info(
+      `Found ${result.total ?? 0} issue(s) assigned to you, showing ${result.issues.length}`
+    );
     return formatSearchResultsResponse(result);
   } catch (error) {
     log6.error("Error in handleGetMyIssues:", error);
@@ -2532,6 +2577,47 @@ async function handleGetCustomFields(input) {
   }
 }
 
+// src/tools/create-issue-link.ts
+var log18 = createLogger("tool:create-issue-link");
+var createIssueLinkTool = {
+  name: TOOL_NAMES.CREATE_ISSUE_LINK,
+  description: 'Creates a link between two Jira issues. Supports common link types like "blocks", "relates", "duplicates", and "clones". Use this to establish relationships between issues.',
+  inputSchema: {
+    type: "object",
+    properties: {
+      fromIssue: {
+        type: "string",
+        description: "Source issue key (e.g., PROJECT-123)"
+      },
+      toIssue: {
+        type: "string",
+        description: "Target issue key (e.g., PROJECT-456)"
+      },
+      linkType: {
+        type: "string",
+        description: 'Link type: "blocks" (fromIssue blocks toIssue), "is blocked by", "relates", "duplicates", "clones", or custom link type name'
+      }
+    },
+    required: ["fromIssue", "toIssue", "linkType"]
+  }
+};
+async function handleCreateIssueLink(input) {
+  try {
+    const validated = validateInput(CreateIssueLinkInputSchema, input);
+    log18.info(
+      `Creating ${validated.linkType} link from ${validated.fromIssue} to ${validated.toIssue}...`
+    );
+    await createIssueLink(validated.fromIssue, validated.toIssue, validated.linkType);
+    log18.info("Issue link created successfully");
+    return formatSuccessResponse(
+      `Link created: ${validated.fromIssue} ${validated.linkType} ${validated.toIssue}`
+    );
+  } catch (error) {
+    log18.error("Error in handleCreateIssueLink:", error);
+    return handleError(error);
+  }
+}
+
 // src/index.ts
 if (process.env.NODE_ENV !== "production") {
   try {
@@ -2540,7 +2626,7 @@ if (process.env.NODE_ENV !== "production") {
   } catch {
   }
 }
-var log18 = createLogger("server");
+var log19 = createLogger("server");
 var toolHandlers = /* @__PURE__ */ new Map([
   [TOOL_NAMES.GET_VISIBLE_PROJECTS, handleGetVisibleProjects],
   [TOOL_NAMES.GET_ISSUE, handleGetIssue],
@@ -2556,7 +2642,8 @@ var toolHandlers = /* @__PURE__ */ new Map([
   [TOOL_NAMES.GET_PROJECT_INFO, handleGetProjectInfo],
   [TOOL_NAMES.CREATE_SUBTASK, handleCreateSubtask],
   [TOOL_NAMES.GET_CREATE_META, handleGetCreateMeta],
-  [TOOL_NAMES.GET_CUSTOM_FIELDS, handleGetCustomFields]
+  [TOOL_NAMES.GET_CUSTOM_FIELDS, handleGetCustomFields],
+  [TOOL_NAMES.CREATE_ISSUE_LINK, handleCreateIssueLink]
 ]);
 var allTools = [
   getVisibleProjectsTool,
@@ -2573,7 +2660,8 @@ var allTools = [
   getProjectInfoTool,
   createSubtaskTool,
   getCreateMetaTool,
-  getCustomFieldsTool
+  getCustomFieldsTool,
+  createIssueLinkTool
 ];
 async function main() {
   const isDryRun = (process.env.DRY_RUN || "").toLowerCase() === "1" || (process.env.DRY_RUN || "").toLowerCase() === "true";
@@ -2644,7 +2732,7 @@ async function main() {
   console.error("\u{1F680} Jira MCP server running on stdio");
 }
 main().catch((error) => {
-  log18.error("Fatal error:", error);
+  log19.error("Fatal error:", error);
   process.exit(1);
 });
 //# sourceMappingURL=index.js.map