backlog-mcp-server 0.4.0 → 0.6.0

package/README.ja.md

@@ -12,6 +12,7 @@ Backlog API とやり取りするための Model Context Protocol（MCP）サー
 
 - プロジェクトツール（作成、読み取り、更新、削除）
 - 課題とコメントの追跡（作成、更新、削除、一覧表示）
+- 発生バージョン/マイルストーンの管理（作成、読み取り、更新、削除）
 - Wikiページサポート
 - Gitリポジトリとプルリクエストツール
 - 通知ツール
@@ -65,7 +66,34 @@ Backlog API とやり取りするための Model Context Protocol（MCP）サー
 docker pull ghcr.io/nulab/backlog-mcp-server:latest
 ```
 
-### オプション2: 手動セットアップ (Node.js)
+### オプション2: npx経由でのインストール
+
+リポジトリをクローンせずに `npx` を使用してサーバーを直接実行することもできます。これは、完全なインストールなしでサーバーを実行する便利な方法です。
+
+1. MCP設定を開きます
+2. MCP設定セクションに移動します
+3. 次の設定を追加します：
+
+```json
+{
+  "mcpServers": {
+    "backlog": {
+      "command": "npx",
+      "args": [
+        "backlog-mcp-server"
+      ],
+      "env": {
+        "BACKLOG_DOMAIN": "your-domain.backlog.com",
+        "BACKLOG_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+`your-domain.backlog.com` を実際のBacklogドメインに、`your-api-key` を実際のBacklog APIキーに置き換えてください。
+
+### オプション3: 手動セットアップ (Node.js)
 
 1. クローンしてインストール：
    ```bash
@@ -105,7 +133,7 @@ docker pull ghcr.io/nulab/backlog-mcp-server:latest
 |-----------------|--------------------------------------------------------------------------------------|
 | `space`         | Backlogスペース設定と一般情報を管理するためのツール                                  |
 | `project`       | プロジェクト、カテゴリ、カスタムフィールド、課題タイプを管理するためのツール             |
-| `issue`         | 課題とそのコメントを管理するためのツール                                             |
+| `issue`         | 課題とそのコメント、発生バージョン/マイルストーンを管理するためのツール                                             |
 | `wiki`          | Wikiページを管理するためのツール                                                     |
 | `git`           | Gitリポジトリとプルリクエストを管理するためのツール                                    |
 | `notifications` | ユーザー通知を管理するためのツール                                                   |

package/README.md

@@ -12,6 +12,7 @@ A Model Context Protocol (MCP) server for interacting with the Backlog API. This
 
 - Project tools (create, read, update, delete)
 - Issue tracking and comments (create, update, delete, list)
+- Version/Milestone management (create, read, update, delete)
 - Wiki page support
 - Git repository and pull request tools
 - Notification tools
@@ -65,7 +66,34 @@ Replace `your-domain.backlog.com` with your Backlog domain and `your-api-key` wi
 docker pull ghcr.io/nulab/backlog-mcp-server:latest
 ```
 
-### Option 2: Manual Setup (Node.js)
+### Option 2: Install via npx
+
+You can also run the server directly using `npx` without cloning the repository. This is a convenient way to run the server without a full installation.
+
+1. Open MCP settings
+2. Navigate to the MCP configuration section
+3. Add the following configuration:
+
+```json
+{
+  "mcpServers": {
+    "backlog": {
+      "command": "npx",
+      "args": [
+        "backlog-mcp-server"
+      ],
+      "env": {
+        "BACKLOG_DOMAIN": "your-domain.backlog.com",
+        "BACKLOG_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Replace `your-domain.backlog.com` with your Backlog domain and `your-api-key` with your Backlog API key.
+
+### Option 3: Manual Setup (Node.js)
 
 1. Clone and install:
    ```bash
@@ -105,7 +133,7 @@ The following toolsets are available (enabled by default when `"all"` is used):
 |-----------------|--------------------------------------------------------------------------------------|
 | `space`         | Tools for managing Backlog space settings and general information                   |
 | `project`       | Tools for managing projects, categories, custom fields, and issue types              |
-| `issue`         | Tools for managing issues and their comments                                         |
+| `issue`         | Tools for managing issues and their comments, version milestones                    |
 | `wiki`          | Tools for managing wiki pages                                                        |
 | `git`           | Tools for managing Git repositories and pull requests                                |
 | `notifications` | Tools for managing user notifications                                                |
@@ -184,6 +212,14 @@ Tools for managing issues, their comments, and related items like priorities, ca
 - `get_resolutions`: Returns list of issue resolutions.
 - `get_watching_list_items`: Returns list of watching items for a user.
 - `get_watching_list_count`: Returns count of watching items for a user.
+- `add_watching`: Adds a new watch to an issue.
+- `update_watching`: Updates an existing watch note.
+- `delete_watching`: Deletes a watch from an issue.
+- `mark_watching_as_read`: Marks a watch as read.
+- `get_version_milestone_list`: Returns list of version milestones for a project.
+- `add_version_milestone`: Creates a new version milestone for a project.
+- `update_version_milestone`: Updates an existing version milestone.
+- `delete_version_milestone`: Deletes a version milestone.
 
 ### Toolset: `wiki`
 Tools for managing wiki pages.

package/build/backlog/customFields.js

@@ -7,10 +7,64 @@ export function customFieldsToPayload(customFields) {
     }
     const result = {};
     for (const field of customFields) {
-        result[`customField_${field.id}`] = field.value;
-        if (field.otherValue) {
+        if (field.value !== undefined) {
+            result[`customField_${field.id}`] = field.value;
+        }
+        if (field.otherValue !== undefined) {
             result[`customField_${field.id}_otherValue`] = field.otherValue;
         }
     }
     return result;
 }
+export function customFieldFiltersToPayload(customFields) {
+    if (!customFields || customFields.length === 0) {
+        return {};
+    }
+    const result = {};
+    for (const field of customFields) {
+        const baseKey = `customField_${field.id}`;
+        switch (field.type) {
+            case 'text': {
+                if (field.value.trim().length > 0) {
+                    result[baseKey] = field.value;
+                }
+                break;
+            }
+            case 'numeric': {
+                if (field.min !== undefined) {
+                    result[`${baseKey}_min`] = field.min;
+                }
+                if (field.max !== undefined) {
+                    result[`${baseKey}_max`] = field.max;
+                }
+                break;
+            }
+            case 'date': {
+                if (field.min) {
+                    result[`${baseKey}_min`] = field.min;
+                }
+                if (field.max) {
+                    result[`${baseKey}_max`] = field.max;
+                }
+                break;
+            }
+            case 'list': {
+                if (Array.isArray(field.value)) {
+                    const values = field.value.filter((value) => Number.isFinite(value));
+                    if (values.length > 0) {
+                        result[`${baseKey}[]`] = values;
+                    }
+                }
+                else if (Number.isFinite(field.value)) {
+                    result[baseKey] = field.value;
+                }
+                break;
+            }
+            default: {
+                const exhaustiveCheck = field;
+                throw new Error(`Unsupported custom field filter type: ${exhaustiveCheck}`);
+            }
+        }
+    }
+    return result;
+}

package/build/index.js

@@ -11,6 +11,7 @@ import { hideBin } from 'yargs/helpers';
 import { createTranslationHelper } from './createTranslationHelper.js';
 import { registerDyamicTools, registerTools } from './registerTools.js';
 import { dynamicTools } from './tools/dynamicTools/toolsets.js';
+import { logger } from './utils/logger.js';
 import { createToolRegistrar } from './utils/toolRegistrar.js';
 import { buildToolsetGroup } from './utils/toolsetUtils.js';
 import { wrapServerWithToolRegistry } from './utils/wrapServerWithToolRegistry.js';
@@ -61,10 +62,7 @@ Available toolsets:
 const useFields = argv.optimizeResponse;
 const server = wrapServerWithToolRegistry(new McpServer({
     name: 'backlog',
-    description: useFields
-        ? `You can include only the fields you need using GraphQL-style syntax.
-Start with the example above and customize freely.`
-        : undefined,
+    title: useFields ? 'backlog (field selection enabled)' : 'backlog',
     version: VERSION,
 }));
 const transHelper = createTranslationHelper();
@@ -94,9 +92,9 @@ if (argv.exportTranslations) {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error('Backlog MCP Server running on stdio');
+    logger.info('Backlog MCP Server running on stdio');
 }
 main().catch((error) => {
-    console.error('Fatal error in main():', error);
+    logger.error({ err: error }, 'Fatal error in main()');
     process.exit(1);
 });

package/build/tools/addIssue.js

@@ -66,7 +66,10 @@ const addIssueSchema = buildToolSchema((t) => ({
         id: z
             .number()
             .describe(t('TOOL_ADD_ISSUE_CUSTOM_FIELD_ID', 'The ID of the custom field (e.g., 12345)')),
-        value: z.union([z.string().max(255), z.number(), z.array(z.string())]),
+        value: z
+            .union([z.number(), z.array(z.number())])
+            .optional()
+            .describe('The ID(s) of the custom field item. For single-select fields, provide a number. For multi-select fields, provide an array of numbers representing the selected item IDs.'),
         otherValue: z
             .string()
             .optional()

package/build/tools/addVersionMilestone.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { VersionSchema } from '../types/zod/backlogOutputDefinition.js';
+import { resolveIdOrKey } from '../utils/resolveIdOrKey.js';
+const addVersionMilestoneSchema = buildToolSchema((t) => ({
+    projectId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_ADD_VERSION_MILESTONE_PROJECT_ID', 'Project ID')),
+    projectKey: z
+        .string()
+        .optional()
+        .describe(t('TOOL_ADD_VERSION_MILESTONE_PROJECT_KEY', 'Project key')),
+    name: z
+        .string()
+        .describe(t('TOOL_ADD_VERSION_MILESTONE_NAME', 'Version name')),
+    description: z
+        .string()
+        .optional()
+        .describe(t('TOOL_ADD_VERSION_MILESTONE_DESCRIPTION', 'Version description')),
+    startDate: z
+        .string()
+        .optional()
+        .describe(t('TOOL_ADD_VERSION_MILESTONE_START_DATE', 'Start date of the version')),
+    releaseDueDate: z
+        .string()
+        .optional()
+        .describe(t('TOOL_ADD_VERSION_MILESTONE_RELEASE_DUE_DATE', 'Release due date of the version')),
+}));
+export const addVersionMilestoneTool = (backlog, { t }) => {
+    return {
+        name: 'add_version_milestone',
+        description: t('TOOL_ADD_VERSION_MILESTONE_DESCRIPTION', 'Creates a new version milestone'),
+        schema: z.object(addVersionMilestoneSchema(t)),
+        outputSchema: VersionSchema,
+        importantFields: [
+            'id',
+            'name',
+            'description',
+            'startDate',
+            'releaseDueDate',
+        ],
+        handler: async ({ projectId, projectKey, ...params }) => {
+            const result = resolveIdOrKey('project', { id: projectId, key: projectKey }, t);
+            if (!result.ok) {
+                throw result.error;
+            }
+            return backlog.postVersions(result.value, params);
+        },
+    };
+};

package/build/tools/addWatching.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { WatchingListItemSchema } from '../types/zod/backlogOutputDefinition.js';
+const addWatchingSchema = buildToolSchema((t) => ({
+    issueIdOrKey: z
+        .union([z.number(), z.string()])
+        .describe(t('TOOL_ADD_WATCHING_ISSUE_ID_OR_KEY', 'Issue ID or issue key (e.g., 1234 or "PROJECT-123")')),
+    note: z
+        .string()
+        .describe(t('TOOL_ADD_WATCHING_NOTE', 'Optional note for the watch'))
+        .optional()
+        .default(''),
+}));
+export const addWatchingTool = (backlog, { t }) => {
+    return {
+        name: 'add_watching',
+        description: t('TOOL_ADD_WATCHING_DESCRIPTION', 'Adds a new watch to an issue'),
+        schema: z.object(addWatchingSchema(t)),
+        outputSchema: WatchingListItemSchema,
+        handler: async ({ issueIdOrKey, note }) => backlog.postWatchingListItem({
+            issueIdOrKey,
+            note,
+        }),
+    };
+};

package/build/tools/countIssues.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
 import { buildToolSchema } from '../types/tool.js';
 import { IssueCountSchema } from '../types/zod/backlogOutputDefinition.js';
-import { customFieldsToPayload } from '../backlog/customFields.js';
+import { customFieldFiltersToPayload } from '../backlog/customFields.js';
+import { buildCustomFieldFilterSchema } from './shared/customFieldFiltersSchema.js';
 const countIssuesSchema = buildToolSchema((t) => ({
     projectId: z
         .array(z.number())
@@ -84,16 +85,9 @@ const countIssuesSchema = buildToolSchema((t) => ({
         .optional()
         .describe(t('TOOL_COUNT_ISSUES_UPDATED_UNTIL', 'Updated until (yyyy-MM-dd)')),
     customFields: z
-        .array(z.object({
-        id: z
-            .number()
-            .describe(t('TOOL_COUNT_ISSUES_CUSTOM_FIELD_ID', 'Custom field ID')),
-        value: z
-            .union([z.string(), z.number(), z.array(z.string())])
-            .describe(t('TOOL_COUNT_ISSUES_CUSTOM_FIELD_VALUE', 'Custom field value')),
-    }))
-        .optional()
-        .describe(t('TOOL_COUNT_ISSUES_CUSTOM_FIELDS', 'Custom fields')),
+        .array(buildCustomFieldFilterSchema(t))
+        .optional()
+        .describe(t('TOOL_COUNT_ISSUES_CUSTOM_FIELDS', 'Custom field filters (text, numeric, date, or list)')),
 }));
 export const countIssuesTool = (backlog, { t }) => {
     return {
@@ -104,7 +98,7 @@ export const countIssuesTool = (backlog, { t }) => {
         handler: async ({ customFields, ...rest }) => {
             return backlog.getIssuesCount({
                 ...rest,
-                ...customFieldsToPayload(customFields),
+                ...customFieldFiltersToPayload(customFields),
             });
         },
     };

package/build/tools/deleteVersion.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { VersionSchema } from '../types/zod/backlogOutputDefinition.js';
+import { resolveIdOrKey } from '../utils/resolveIdOrKey.js';
+const deleteVersionSchema = buildToolSchema((t) => ({
+    projectId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_DELETE_VERSION_PROJECT_ID', 'The numeric ID of the project (e.g., 12345)')),
+    projectKey: z
+        .string()
+        .optional()
+        .describe(t('TOOL_DELETE_VERSION_PROJECT_KEY', "The key of the project (e.g., 'PROJECT')")),
+    id: z
+        .number()
+        .describe(t('TOOL_DELETE_VERSION_ID', 'The numeric ID of the version to delete (e.g., 67890)')),
+}));
+export const deleteVersionTool = (backlog, { t }) => {
+    return {
+        name: 'delete_version',
+        description: t('TOOL_DELETE_VERSION_DESCRIPTION', 'Deletes a version from a project'),
+        schema: z.object(deleteVersionSchema(t)),
+        outputSchema: VersionSchema,
+        handler: async ({ projectId, projectKey, id }) => {
+            const result = resolveIdOrKey('project', { id: projectId, key: projectKey }, t);
+            if (!result.ok) {
+                throw result.error;
+            }
+            if (!id) {
+                throw new Error(t('TOOL_DELETE_VERSION_MISSING_ID', 'Version ID is required'));
+            }
+            return backlog.deleteVersions(result.value, id);
+        },
+    };
+};

package/build/tools/deleteWatching.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { WatchingListItemSchema } from '../types/zod/backlogOutputDefinition.js';
+const deleteWatchingSchema = buildToolSchema((t) => ({
+    watchId: z
+        .number()
+        .describe(t('TOOL_DELETE_WATCHING_WATCH_ID', 'Watch ID to delete')),
+}));
+export const deleteWatchingTool = (backlog, { t }) => {
+    return {
+        name: 'delete_watching',
+        description: t('TOOL_DELETE_WATCHING_DESCRIPTION', 'Deletes a watch from an issue'),
+        schema: z.object(deleteWatchingSchema(t)),
+        outputSchema: WatchingListItemSchema,
+        handler: async ({ watchId }) => backlog.deletehWatchingListItem(watchId),
+    };
+};

package/build/tools/getIssues.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
 import { buildToolSchema } from '../types/tool.js';
 import { IssueSchema } from '../types/zod/backlogOutputDefinition.js';
-import { customFieldsToPayload } from '../backlog/customFields.js';
+import { customFieldFiltersToPayload } from '../backlog/customFields.js';
+import { buildCustomFieldFilterSchema } from './shared/customFieldFiltersSchema.js';
 const getIssuesSchema = buildToolSchema((t) => ({
     projectId: z
         .array(z.number())
@@ -120,16 +121,9 @@ const getIssuesSchema = buildToolSchema((t) => ({
         .optional()
         .describe(t('TOOL_GET_ISSUES_COUNT', 'Number of issues to retrieve')),
     customFields: z
-        .array(z.object({
-        id: z
-            .number()
-            .describe(t('TOOL_GET_ISSUES_CUSTOM_FIELD_ID', 'Custom field ID')),
-        value: z
-            .union([z.string(), z.number(), z.array(z.string())])
-            .describe(t('TOOL_GET_ISSUES_CUSTOM_FIELD_VALUE', 'Custom field value')),
-    }))
-        .optional()
-        .describe(t('TOOL_GET_ISSUES_CUSTOM_FIELDS', 'Custom fields')),
+        .array(buildCustomFieldFilterSchema(t))
+        .optional()
+        .describe(t('TOOL_GET_ISSUES_CUSTOM_FIELDS', 'Custom field filters (text, numeric, date, or list)')),
 }));
 export const getIssuesTool = (backlog, { t }) => {
     return {
@@ -148,7 +142,7 @@ export const getIssuesTool = (backlog, { t }) => {
         handler: async ({ customFields, ...rest }) => {
             return backlog.getIssues({
                 ...rest,
-                ...customFieldsToPayload(customFields),
+                ...customFieldFiltersToPayload(customFields),
             });
         },
     };

package/build/tools/getVersionMilestoneList.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { VersionSchema } from '../types/zod/backlogOutputDefinition.js';
+import { resolveIdOrKey } from '../utils/resolveIdOrKey.js';
+const getVersionMilestoneListSchema = buildToolSchema((t) => ({
+    projectId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_GET_VERSION_MILESTONE_PROJECT_ID', 'The numeric ID of the project (e.g., 12345)')),
+    projectKey: z
+        .string()
+        .optional()
+        .describe(t('TOOL_GET_VERSION_MILESTONE_PROJECT_KEY', 'The key of the project (e.g., TEST_PROJECT)')),
+}));
+export const getVersionMilestoneListTool = (backlog, { t }) => {
+    return {
+        name: 'get_version_milestone_list',
+        description: t('TOOL_GET_VERSION_MILESTONE_LIST_DESCRIPTION', 'Returns list of versions/milestones in the Backlog space'),
+        schema: z.object(getVersionMilestoneListSchema(t)),
+        outputSchema: VersionSchema,
+        importantFields: [
+            'id',
+            'name',
+            'description',
+            'startDate',
+            'releaseDueDate',
+            'archived',
+        ],
+        handler: async ({ projectId, projectKey }) => {
+            const result = resolveIdOrKey('project', { id: projectId, key: projectKey }, t);
+            if (!result.ok) {
+                throw result.error;
+            }
+            return backlog.getVersions(result.value);
+        },
+    };
+};

package/build/tools/markWatchingAsRead.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+const markWatchingAsReadSchema = buildToolSchema((t) => ({
+    watchId: z
+        .number()
+        .describe(t('TOOL_MARK_WATCHING_AS_READ_WATCH_ID', 'Watch ID to mark as read')),
+}));
+export const MarkWatchingAsReadResultSchema = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+export const markWatchingAsReadTool = (backlog, { t }) => {
+    return {
+        name: 'mark_watching_as_read',
+        description: t('TOOL_MARK_WATCHING_AS_READ_DESCRIPTION', 'Mark a watch as read'),
+        schema: z.object(markWatchingAsReadSchema(t)),
+        outputSchema: MarkWatchingAsReadResultSchema,
+        handler: async ({ watchId }) => {
+            await backlog.resetWatchingListItemAsRead(watchId);
+            return {
+                success: true,
+                message: `Watch ${watchId} marked as read`,
+            };
+        },
+    };
+};

package/build/tools/shared/customFieldFiltersSchema.js

@@ -0,0 +1,78 @@
+import { z, ZodIssueCode } from 'zod';
+export const buildCustomFieldFilterSchema = (t) => {
+    const schema = z.discriminatedUnion('type', [
+        z
+            .object({
+            type: z.literal('text'),
+            id: z
+                .number()
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_ID', 'Custom field ID (e.g., 12345)')),
+            value: z
+                .string()
+                .min(1)
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_TEXT_VALUE', 'Keyword to match for the custom field')),
+        })
+            .describe(t('TOOL_CUSTOM_FIELD_FILTER_TEXT', 'Text custom field filter')),
+        z
+            .object({
+            type: z.literal('numeric'),
+            id: z
+                .number()
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_ID', 'Custom field ID (e.g., 12345)')),
+            min: z
+                .number()
+                .optional()
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_NUMERIC_MIN', 'Minimum numeric value (inclusive)')),
+            max: z
+                .number()
+                .optional()
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_NUMERIC_MAX', 'Maximum numeric value (inclusive)')),
+        })
+            .describe(t('TOOL_CUSTOM_FIELD_FILTER_NUMERIC', 'Numeric custom field filter')),
+        z
+            .object({
+            type: z.literal('date'),
+            id: z
+                .number()
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_ID', 'Custom field ID (e.g., 12345)')),
+            min: z
+                .string()
+                .optional()
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_DATE_MIN', 'Start date (yyyy-MM-dd)')),
+            max: z
+                .string()
+                .optional()
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_DATE_MAX', 'End date (yyyy-MM-dd)')),
+        })
+            .describe(t('TOOL_CUSTOM_FIELD_FILTER_DATE', 'Date custom field filter')),
+        z
+            .object({
+            type: z.literal('list'),
+            id: z
+                .number()
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_ID', 'Custom field ID (e.g., 12345)')),
+            value: z
+                .union([z.number(), z.array(z.number()).min(1)])
+                .describe(t('TOOL_CUSTOM_FIELD_FILTER_LIST_VALUE', 'Value ID(s) to match for list-type custom field')),
+        })
+            .describe(t('TOOL_CUSTOM_FIELD_FILTER_LIST', 'List custom field filter')),
+    ]);
+    return schema.superRefine((data, ctx) => {
+        if (data.type === 'numeric' &&
+            data.min === undefined &&
+            data.max === undefined) {
+            ctx.addIssue({
+                code: ZodIssueCode.custom,
+                message: t('TOOL_CUSTOM_FIELD_FILTER_NUMERIC_REQUIRED', 'Provide at least one of min or max for numeric filters'),
+                path: ['min'],
+            });
+        }
+        if (data.type === 'date' && !data.min && !data.max) {
+            ctx.addIssue({
+                code: ZodIssueCode.custom,
+                message: t('TOOL_CUSTOM_FIELD_FILTER_DATE_REQUIRED', 'Provide at least one of min or max for date filters'),
+                path: ['min'],
+            });
+        }
+    });
+};

package/build/tools/tools.js

@@ -4,6 +4,7 @@ import { addProjectTool } from './addProject.js';
 import { addPullRequestTool } from './addPullRequest.js';
 import { addPullRequestCommentTool } from './addPullRequestComment.js';
 import { addWikiTool } from './addWiki.js';
+import { updateWikiTool } from './updateWiki.js';
 import { countIssuesTool } from './countIssues.js';
 import { deleteIssueTool } from './deleteIssue.js';
 import { deleteProjectTool } from './deleteProject.js';
@@ -30,6 +31,10 @@ import { getSpaceTool } from './getSpace.js';
 import { getUsersTool } from './getUsers.js';
 import { getWatchingListCountTool } from './getWatchingListCount.js';
 import { getWatchingListItemsTool } from './getWatchingListItems.js';
+import { addWatchingTool } from './addWatching.js';
+import { updateWatchingTool } from './updateWatching.js';
+import { deleteWatchingTool } from './deleteWatching.js';
+import { markWatchingAsReadTool } from './markWatchingAsRead.js';
 import { getWikiTool } from './getWiki.js';
 import { getWikiPagesTool } from './getWikiPages.js';
 import { getWikisCountTool } from './getWikisCount.js';
@@ -42,6 +47,10 @@ import { updatePullRequestCommentTool } from './updatePullRequestComment.js';
 import { getDocumentTool } from './getDocument.js';
 import { getDocumentsTool } from './getDocuments.js';
 import { getDocumentTreeTool } from './getDocumentTree.js';
+import { getVersionMilestoneListTool } from './getVersionMilestoneList.js';
+import { addVersionMilestoneTool } from './addVersionMilestone.js';
+import { updateVersionMilestoneTool } from './updateVersionMilestone.js';
+import { deleteVersionTool } from './deleteVersion.js';
 export const allTools = (backlog, helper) => {
     return {
         toolsets: [
@@ -87,6 +96,14 @@ export const allTools = (backlog, helper) => {
                     getResolutionsTool(backlog, helper),
                     getWatchingListItemsTool(backlog, helper),
                     getWatchingListCountTool(backlog, helper),
+                    addWatchingTool(backlog, helper),
+                    updateWatchingTool(backlog, helper),
+                    deleteWatchingTool(backlog, helper),
+                    markWatchingAsReadTool(backlog, helper),
+                    getVersionMilestoneListTool(backlog, helper),
+                    addVersionMilestoneTool(backlog, helper),
+                    updateVersionMilestoneTool(backlog, helper),
+                    deleteVersionTool(backlog, helper),
                 ],
             },
             {
@@ -98,6 +115,7 @@ export const allTools = (backlog, helper) => {
                     getWikisCountTool(backlog, helper),
                     getWikiTool(backlog, helper),
                     addWikiTool(backlog, helper),
+                    updateWikiTool(backlog, helper),
                 ],
             },
             {

package/build/tools/updateIssue.js

@@ -85,7 +85,10 @@ const updateIssueSchema = buildToolSchema((t) => ({
         id: z
             .number()
             .describe(t('TOOL_UPDATE_ISSUE_CUSTOM_FIELD_ID', 'The ID of the custom field (e.g., 12345)')),
-        value: z.union([z.string().max(255), z.number(), z.array(z.string())]),
+        value: z
+            .union([z.number(), z.array(z.number())])
+            .optional()
+            .describe('The ID(s) of the custom field item. For single-select fields, provide a number. For multi-select fields, provide an array of numbers representing the selected item IDs.'),
         otherValue: z
             .string()
             .optional()

package/build/tools/updateVersionMilestone.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { VersionSchema } from '../types/zod/backlogOutputDefinition.js';
+import { resolveIdOrKey } from '../utils/resolveIdOrKey.js';
+const updateVersionMilestoneSchema = buildToolSchema((t) => ({
+    projectId: z
+        .number()
+        .optional()
+        .describe(t('TOOL_UPDATE_VERSION_MILESTONE_PROJECT_ID', 'The numeric ID of the project (e.g., 12345)')),
+    projectKey: z
+        .string()
+        .optional()
+        .describe(t('TOOL_UPDATE_VERSION_MILESTONE_PROJECT_KEY', "The key of the project (e.g., 'PROJECT')")),
+    id: z.number().describe(t('TOOL_UPDATE_VERSION_MILESTONE_ID', 'Version ID')),
+    name: z
+        .string()
+        .describe(t('TOOL_UPDATE_VERSION_MILESTONE_NAME', 'Version name')),
+    description: z
+        .string()
+        .optional()
+        .describe(t('TOOL_UPDATE_VERSION_MILESTONE_DESCRIPTION', 'Version description')),
+    startDate: z
+        .string()
+        .optional()
+        .describe(t('TOOL_UPDATE_VERSION_MILESTONE_START_DATE', 'Start date')),
+    releaseDueDate: z
+        .string()
+        .optional()
+        .describe(t('TOOL_UPDATE_VERSION_MILESTONE_RELEASE_DUE_DATE', 'Release due date')),
+    archived: z
+        .boolean()
+        .optional()
+        .describe(t('TOOL_UPDATE_VERSION_MILESTONE_ARCHIVED', 'Archive status of the version')),
+}));
+export const updateVersionMilestoneTool = (backlog, { t }) => {
+    return {
+        name: 'update_version_milestone',
+        description: t('TOOL_UPDATE_VERSION_MILESTONE_DESCRIPTION', 'Updates an existing version milestone'),
+        schema: z.object(updateVersionMilestoneSchema(t)),
+        outputSchema: VersionSchema,
+        importantFields: [
+            'id',
+            'name',
+            'description',
+            'startDate',
+            'releaseDueDate',
+            'archived',
+        ],
+        handler: async ({ projectId, projectKey, id, ...params }) => {
+            const result = resolveIdOrKey('project', { id: projectId, key: projectKey }, t);
+            if (!result.ok) {
+                throw result.error;
+            }
+            return backlog.patchVersions(result.value, id, params);
+        },
+    };
+};

package/build/tools/updateWatching.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { WatchingListItemSchema } from '../types/zod/backlogOutputDefinition.js';
+const updateWatchingSchema = buildToolSchema((t) => ({
+    watchId: z.number().describe(t('TOOL_UPDATE_WATCHING_WATCH_ID', 'Watch ID')),
+    note: z
+        .string()
+        .describe(t('TOOL_UPDATE_WATCHING_NOTE', 'Updated note for the watch')),
+}));
+export const updateWatchingTool = (backlog, { t }) => {
+    return {
+        name: 'update_watching',
+        description: t('TOOL_UPDATE_WATCHING_DESCRIPTION', 'Updates an existing watch note'),
+        schema: z.object(updateWatchingSchema(t)),
+        outputSchema: WatchingListItemSchema,
+        handler: async ({ watchId, note }) => backlog.patchWatchingListItem(watchId, note),
+    };
+};

package/build/tools/updateWiki.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { buildToolSchema } from '../types/tool.js';
+import { WikiSchema } from '../types/zod/backlogOutputDefinition.js';
+const updateWikiSchema = buildToolSchema((t) => ({
+    wikiId: z
+        .union([z.string(), z.number()])
+        .describe(t('TOOL_UPDATE_WIKI_ID', 'Wiki ID')),
+    name: z
+        .string()
+        .optional()
+        .describe(t('TOOL_UPDATE_WIKI_NAME', 'Name of the wiki page')),
+    content: z
+        .string()
+        .optional()
+        .describe(t('TOOL_UPDATE_WIKI_CONTENT', 'Content of the wiki page')),
+    mailNotify: z
+        .boolean()
+        .optional()
+        .describe(t('TOOL_UPDATE_WIKI_MAIL_NOTIFY', 'Whether to send notification emails (default: false)')),
+}));
+export const updateWikiTool = (backlog, { t }) => {
+    return {
+        name: 'update_wiki',
+        description: t('TOOL_UPDATE_WIKI_DESCRIPTION', 'Updates an existing wiki page'),
+        schema: z.object(updateWikiSchema(t)),
+        outputSchema: WikiSchema,
+        importantFields: ['id', 'name', 'content', 'updatedUser'],
+        handler: async ({ wikiId, name, content, mailNotify }) => {
+            const wikiIdNumber = typeof wikiId === 'string' ? parseInt(wikiId, 10) : wikiId;
+            return backlog.patchWiki(wikiIdNumber, {
+                name,
+                content,
+                mailNotify,
+            });
+        },
+    };
+};

package/build/utils/logger.js

@@ -0,0 +1,20 @@
+import pino from 'pino';
+if (!process.env.NODE_ENV) {
+    process.env.NODE_ENV = 'production';
+}
+const isProd = process.env.NODE_ENV === 'production';
+export const logger = pino({
+    level: isProd ? 'error' : 'debug',
+    transport: isProd
+        ? undefined
+        : {
+            target: 'pino-pretty',
+            options: {
+                destination: 2,
+                colorize: true,
+                translateTime: 'SYS:yyyy-mm-dd HH:MM:ss.l',
+                ignore: 'pid,hostname',
+                singleLine: true,
+            },
+        },
+}, isProd ? pino.destination({ dest: 2, sync: false }) : undefined);

package/build/version.js

@@ -1 +1 @@
-export const VERSION = '0.4.0';
+export const VERSION = '0.6.0';

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "backlog-mcp-server",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "type": "module",
   "bin": {
     "backlog-mcp-server": "./build/index.js"
   },
   "license": "MIT",
   "scripts": {
+    "dev": "tsx src/index.ts",
     "prebuild": "node scripts/replace-version.js",
     "build": "tsc && chmod 755 build/index.js",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
@@ -20,19 +21,21 @@
     "build"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.9.0",
-    "backlog-js": "^0.13.6",
+    "@modelcontextprotocol/sdk": "^1.24.0",
+    "backlog-js": "^0.15.0",
     "cosmiconfig": "^9.0.0",
     "dotenv": "^16.5.0",
     "env-var": "^7.5.0",
     "graphql": "^16.11.0",
-    "node-fetch": "^3.3.2",
+    "pino": "^9.9.0",
+    "pino-pretty": "^13.1.1",
     "yargs": "^18.0.0",
     "zod": "^3.24.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.24.0",
-    "@release-it/conventional-changelog": "^10.0.1",
+    "tsx": "^4.20.6",
+    "@release-it/conventional-changelog": "^10.0.2",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.14.1",
     "@types/yargs": "^17.0.33",

package/build/tools/downloadDocumentAttachment.js

@@ -1 +0,0 @@
-export {};