backlog-mcp-server 0.13.1 → 0.13.3

package/README.ja.md

@@ -363,18 +363,6 @@ docker run -i --rm ghcr.io/nulab/backlog-mcp-server node build/index.js --export
 npx github:nulab/backlog-mcp-server --export-translations
 ```
 
-### 日本語翻訳テンプレートの使用
-
-サンプルの日本語設定ファイルは次の場所に提供されています：
-
-```bash
-translationConfig/.backlog-mcp-serverrc.json.example
-```
-
-これを使用するには、ホームディレクトリに `.backlog-mcp-serverrc.json` としてコピーします：
-
-その後、必要に応じてファイルを編集して説明をカスタマイズできます。
-
 ### 環境変数の使用
 
 または、環境変数を介してツールの説明をオーバーライドすることもできます。

package/README.md

@@ -305,6 +305,7 @@ Tools for managing issues, their comments, and related items like priorities, ca
 - `delete_issue`: Deletes an issue.
 - `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_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.
@@ -472,18 +473,6 @@ or
 npx github:nulab/backlog-mcp-server --export-translations
 ```
 
-### Using a Japanese Translation Template
-
-A sample Japanese configuration file is provided at:
-
-```bash
-translationConfig/.backlog-mcp-serverrc.json.example
-```
-
-To use it, copy it to your home directory as .backlog-mcp-serverrc.json:
-
-You can then edit the file to customize the descriptions as needed.
-
 ### Using Environment Variables
 
 Alternatively, you can override tool descriptions via environment variables.

package/build/index.js

@@ -145,6 +145,19 @@ const createServer = () => createBacklogMcpServer({
     dynamicToolsets: argv.dynamicToolsets,
 });
 if (argv.exportTranslations) {
+    // Translation keys are only recorded once a tool asks for them, so build a
+    // server with every toolset enabled before dumping. Without this the dump is
+    // empty, because no tool has been created yet at this point.
+    createBacklogMcpServer({
+        version,
+        useFields,
+        backlog,
+        clientRegistry,
+        transHelper,
+        enabledToolsets: ['all'],
+        mcpOption,
+        dynamicToolsets: true,
+    });
     const data = transHelper.dump();
     // eslint-disable-next-line no-console
     console.log(JSON.stringify(data, null, 2));

package/build/tools/tools.js

@@ -45,6 +45,7 @@ import { getWikisCountTool } from './getWikisCount.js';
 import { markNotificationAsReadTool } from './markNotificationAsRead.js';
 import { resetUnreadNotificationCountTool } from './resetUnreadNotificationCount.js';
 import { updateIssueTool } from './updateIssue.js';
+import { updateIssueCommentTool } from './updateIssueComment.js';
 import { updateProjectTool } from './updateProject.js';
 import { updatePullRequestTool } from './updatePullRequest.js';
 import { updatePullRequestCommentTool } from './updatePullRequestComment.js';
@@ -98,6 +99,7 @@ export const allTools = (backlog, helper) => {
                     deleteIssueTool(backlog, helper),
                     getIssueCommentsTool(backlog, helper),
                     addIssueCommentTool(backlog, helper),
+                    updateIssueCommentTool(backlog, helper),
                     getPrioritiesTool(backlog, helper),
                     getCategoriesTool(backlog, helper),
                     getCustomFieldsTool(backlog, helper),

package/build/tools/updateIssueComment.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { IssueCommentSchema } from '../types/zod/backlogOutputDefinition.js';
+import { resolveIdOrKey } from '../utils/resolveIdOrKey.js';
+const updateIssueCommentSchema = buildToolSchema((t) => ({
+    issueId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_UPDATE_ISSUE_COMMENT_ISSUE_ID', 'The numeric ID of the issue (e.g., 12345)')),
+    issueKey: z
+        .string()
+        .optional()
+        .describe(t('TOOL_UPDATE_ISSUE_COMMENT_ISSUE_KEY', "The key of the issue (e.g., 'PROJ-123')")),
+    commentId: z
+        .number()
+        .describe(t('TOOL_UPDATE_ISSUE_COMMENT_COMMENT_ID', 'Comment ID')),
+    content: z
+        .string()
+        .describe(t('TOOL_UPDATE_ISSUE_COMMENT_CONTENT', 'Comment content')),
+}));
+export const updateIssueCommentTool = (backlog, { t }) => {
+    return {
+        name: 'update_issue_comment',
+        description: t('TOOL_UPDATE_ISSUE_COMMENT_DESCRIPTION', 'Updates a comment on an issue'),
+        schema: z.object(updateIssueCommentSchema(t)),
+        outputSchema: IssueCommentSchema,
+        importantFields: ['id', 'content', 'createdUser', 'updated'],
+        handler: async ({ issueId, issueKey, commentId, content }) => {
+            const result = resolveIdOrKey('issue', { id: issueId, key: issueKey }, t);
+            if (!result.ok) {
+                throw result.error;
+            }
+            return backlog.patchIssueComment(result.value, commentId, { content });
+        },
+    };
+};

package/build/types/zod/backlogOutputDefinition.js

@@ -158,6 +158,18 @@ export const CustomFieldSchema = z.object({
     required: z.boolean(),
     applicableIssueTypes: z.array(z.number()),
 });
+// A custom field *value* attached to an issue (as returned by the Backlog API),
+// as opposed to a custom field *definition* (CustomFieldSchema above). The
+// concrete `value` shape depends on the field type, so it is left unconstrained.
+export const CustomFieldValueSchema = z.object({
+    id: z.number(),
+    fieldTypeId: CustomFieldTypeSchema,
+    name: z.string(),
+    value: z.unknown(),
+    // Present on "checkbox" / "radio" fields that allow free-text input for an
+    // "other" option; holds whatever the user typed there (null when unused).
+    otherValue: z.string().nullable().optional(),
+});
 export const SharedFileSchema = z.object({
     id: z.number(),
     projectId: z.number(),
@@ -194,7 +206,7 @@ export const IssueSchema = z.object({
     created: z.string(),
     updatedUser: UserSchema,
     updated: z.string(),
-    customFields: z.array(CustomFieldSchema),
+    customFields: z.array(CustomFieldValueSchema),
     attachments: z.array(IssueFileInfoSchema),
     sharedFiles: z.array(SharedFileSchema),
     stars: z.array(StarSchema),

package/build/utils/backlogClientRegistry.js

@@ -1,6 +1,10 @@
 import { Backlog } from 'backlog-js';
 import { getCurrentAccessToken } from '../auth/backlogAuthContext.js';
 import { getCurrentOrganization } from './backlogOrganizationContext.js';
+import packageJson from '../../package.json' with { type: 'json' };
+// Sent as the User-Agent header on Backlog API requests so that traffic
+// originating from this MCP Server can be identified in access logs / observability tooling.
+const USER_AGENT = `backlog-mcp-server/${packageJson.version}`;
 export function createBacklogClientRegistry(input = {}) {
     const env = input.env ?? process.env;
     const multiOrgRegistry = createMultiOrganizationRegistryFromEnv(env);
@@ -13,7 +17,7 @@ export function createBacklogClientRegistry(input = {}) {
         throw new Error('Configure either BACKLOG_ORG_<NAME>_DOMAIN and BACKLOG_ORG_<NAME>_API_KEY with BACKLOG_DEFAULT_ORG, or both BACKLOG_DOMAIN and BACKLOG_API_KEY.');
     }
     const defaultName = 'default';
-    const client = new Backlog({ host: domain, apiKey });
+    const client = new Backlog({ host: domain, apiKey, userAgent: USER_AGENT });
     const info = {
         name: defaultName,
         domain,
@@ -87,6 +91,7 @@ function createMultiOrganizationRegistryFromEnv(env) {
         clients.set(name, new Backlog({
             host: config.domain,
             apiKey: config.apiKey,
+            userAgent: USER_AGENT,
         }));
         return {
             name,
@@ -131,7 +136,11 @@ export function createOAuthBacklogClientRegistry(domain) {
         if (!token) {
             throw new Error('No OAuth access token in current request context');
         }
-        return new Backlog({ host: domain, accessToken: token });
+        return new Backlog({
+            host: domain,
+            accessToken: token,
+            userAgent: USER_AGENT,
+        });
     };
     return {
         resolveClient: () => resolveOAuthClient(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backlog-mcp-server",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "type": "module",
   "bin": {
     "backlog-mcp-server": "./build/index.js"
@@ -24,13 +24,13 @@
     "build"
   ],
   "dependencies": {
-    "@hono/node-server": "^2.0.4",
+    "@hono/node-server": "^2.0.10",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "backlog-js": "^0.16.0",
+    "backlog-js": "^0.18.1",
     "cosmiconfig": "^9.0.1",
     "env-var": "^7.5.0",
     "graphql": "^16.14.1",
-    "hono": "^4.12.25",
+    "hono": "^4.12.27",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
     "yargs": "^18.0.0",