backlog-mcp-server 0.13.4 → 0.14.0

package/README.md

@@ -1,5 +1,6 @@
 # Backlog MCP Server
 
+[![MCP Toplist](https://mcptoplist.com/badge/glama%2Fnulab%2Fbacklog-mcp-server.svg)](https://mcptoplist.com/server/glama%2Fnulab%2Fbacklog-mcp-server)
 ![MIT License](https://img.shields.io/badge/license-MIT-green.svg)
 ![Build](https://github.com/nulab/backlog-mcp-server/actions/workflows/ci.yml/badge.svg)
 ![Last Commit](https://img.shields.io/github/last-commit/nulab/backlog-mcp-server.svg)
@@ -306,6 +307,9 @@ Tools for managing issues, their comments, and related items like priorities, ca
 - `get_issue_comments`: Returns list of comments for an issue.
 - `add_issue_comment`: Adds a comment to an issue.
 - `update_issue_comment`: Updates a comment on an issue.
+- `get_related_issues`: Returns list of issues related to a specific issue.
+- `add_related_issue`: Relates an issue to another issue.
+- `remove_related_issue`: Removes the relation between an issue and a related issue.
 - `get_priorities`: Returns list of priorities.
 - `get_categories`: Returns list of categories for a project.
 - `get_custom_fields`: Returns list of custom fields for a project.

package/build/tools/addRelatedIssue.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { RelatedIssueSchema } from '../types/zod/backlogOutputDefinition.js';
+import { resolveIdOrKey } from '../utils/resolveIdOrKey.js';
+const addRelatedIssueSchema = buildToolSchema((t) => ({
+    issueId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_ADD_RELATED_ISSUE_ISSUE_ID', 'The numeric ID of the issue (e.g., 12345)')),
+    issueKey: z
+        .string()
+        .optional()
+        .describe(t('TOOL_ADD_RELATED_ISSUE_ISSUE_KEY', "The key of the issue (e.g., 'PROJ-123')")),
+    targetIssueId: z
+        .number()
+        .describe(t('TOOL_ADD_RELATED_ISSUE_TARGET_ISSUE_ID', 'The numeric ID of the issue to relate to (e.g., 12346)')),
+}));
+export const addRelatedIssueTool = (backlog, { t }) => {
+    return {
+        name: 'add_related_issue',
+        description: t('TOOL_ADD_RELATED_ISSUE_DESCRIPTION', 'Relates an issue to another issue'),
+        schema: z.object(addRelatedIssueSchema(t)),
+        outputSchema: RelatedIssueSchema,
+        handler: async ({ issueId, issueKey, targetIssueId }) => {
+            const result = resolveIdOrKey('issue', { id: issueId, key: issueKey }, t);
+            if (!result.ok) {
+                throw result.error;
+            }
+            return backlog.addRelatedIssue(result.value, { targetIssueId });
+        },
+    };
+};

package/build/tools/getRelatedIssues.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { RelatedIssueSchema } from '../types/zod/backlogOutputDefinition.js';
+import { resolveIdOrKey } from '../utils/resolveIdOrKey.js';
+const getRelatedIssuesSchema = buildToolSchema((t) => ({
+    issueId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_GET_RELATED_ISSUES_ISSUE_ID', 'The numeric ID of the issue (e.g., 12345)')),
+    issueKey: z
+        .string()
+        .optional()
+        .describe(t('TOOL_GET_RELATED_ISSUES_ISSUE_KEY', "The key of the issue (e.g., 'PROJ-123')")),
+}));
+export const getRelatedIssuesTool = (backlog, { t }) => {
+    return {
+        name: 'get_related_issues',
+        description: t('TOOL_GET_RELATED_ISSUES_DESCRIPTION', 'Returns list of issues related to a specific issue'),
+        schema: z.object(getRelatedIssuesSchema(t)),
+        importantFields: ['issueKey', 'summary', 'status', 'type'],
+        outputSchema: RelatedIssueSchema,
+        handler: async ({ issueId, issueKey }) => {
+            const result = resolveIdOrKey('issue', { id: issueId, key: issueKey }, t);
+            if (!result.ok) {
+                throw result.error;
+            }
+            return backlog.getRelatedIssues(result.value);
+        },
+    };
+};

package/build/tools/removeRelatedIssue.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { RelatedIssueSchema } from '../types/zod/backlogOutputDefinition.js';
+import { resolveIdOrKey } from '../utils/resolveIdOrKey.js';
+const removeRelatedIssueSchema = buildToolSchema((t) => ({
+    issueId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_REMOVE_RELATED_ISSUE_ISSUE_ID', 'The numeric ID of the issue (e.g., 12345)')),
+    issueKey: z
+        .string()
+        .optional()
+        .describe(t('TOOL_REMOVE_RELATED_ISSUE_ISSUE_KEY', "The key of the issue (e.g., 'PROJ-123')")),
+    relatedIssueId: z
+        .number()
+        .describe(t('TOOL_REMOVE_RELATED_ISSUE_RELATED_ISSUE_ID', 'The numeric ID of the related issue to unlink (e.g., 12346)')),
+}));
+export const removeRelatedIssueTool = (backlog, { t }) => {
+    return {
+        name: 'remove_related_issue',
+        description: t('TOOL_REMOVE_RELATED_ISSUE_DESCRIPTION', 'Removes the relation between an issue and a related issue'),
+        schema: z.object(removeRelatedIssueSchema(t)),
+        outputSchema: RelatedIssueSchema,
+        handler: async ({ issueId, issueKey, relatedIssueId }) => {
+            const result = resolveIdOrKey('issue', { id: issueId, key: issueKey }, t);
+            if (!result.ok) {
+                throw result.error;
+            }
+            return backlog.removeRelatedIssue(result.value, relatedIssueId);
+        },
+    };
+};

package/build/tools/tools.js

@@ -15,6 +15,9 @@ import { getGitRepositoryTool } from './getGitRepository.js';
 import { getIssueTool } from './getIssue.js';
 import { getIssueCommentsTool } from './getIssueComments.js';
 import { getIssuesTool } from './getIssues.js';
+import { getRelatedIssuesTool } from './getRelatedIssues.js';
+import { addRelatedIssueTool } from './addRelatedIssue.js';
+import { removeRelatedIssueTool } from './removeRelatedIssue.js';
 import { getIssueTypesTool } from './getIssueTypes.js';
 import { getMyselfTool } from './getMyself.js';
 import { getNotificationsTool } from './getNotifications.js';
@@ -100,6 +103,9 @@ export const allTools = (backlog, helper) => {
                     getIssueCommentsTool(backlog, helper),
                     addIssueCommentTool(backlog, helper),
                     updateIssueCommentTool(backlog, helper),
+                    getRelatedIssuesTool(backlog, helper),
+                    addRelatedIssueTool(backlog, helper),
+                    removeRelatedIssueTool(backlog, helper),
                     getPrioritiesTool(backlog, helper),
                     getCategoriesTool(backlog, helper),
                     getCustomFieldsTool(backlog, helper),

package/build/tools/updateIssue.js

@@ -76,6 +76,10 @@ const updateIssueSchema = buildToolSchema((t) => ({
         .array(z.number())
         .optional()
         .describe(t('TOOL_UPDATE_ISSUE_ATTACHMENT_ID', 'Attachment IDs')),
+    parentIssueId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_UPDATE_ISSUE_PARENT_ISSUE_ID', 'Parent issue ID')),
     comment: z
         .string()
         .optional()

package/build/types/zod/backlogOutputDefinition.js

@@ -211,6 +211,10 @@ export const IssueSchema = z.object({
     sharedFiles: z.array(SharedFileSchema),
     stars: z.array(StarSchema),
 });
+// An issue plus the relation type that links it to the issue it was fetched from.
+export const RelatedIssueSchema = IssueSchema.extend({
+    type: z.string(),
+});
 export const ProjectSchema = z.object({
     id: z.number(),
     projectKey: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backlog-mcp-server",
-  "version": "0.13.4",
+  "version": "0.14.0",
   "type": "module",
   "bin": {
     "backlog-mcp-server": "./build/index.js"
@@ -26,7 +26,7 @@
   "dependencies": {
     "@hono/node-server": "^2.0.10",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "backlog-js": "^0.18.1",
+    "backlog-js": "^0.19.0",
     "cosmiconfig": "^9.0.1",
     "env-var": "^7.5.0",
     "graphql": "^16.14.1",