@kintone/mcp-server 1.1.0 → 1.2.1

package/dist/tools/kintone/app/add-app.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+const inputSchema = {
+    name: z
+        .string()
+        .max(64)
+        .describe("The name of the app to create (max 64 characters)"),
+    space: z
+        .number()
+        .optional()
+        .describe("The space ID where the app will be created"),
+};
+const outputSchema = {
+    app: z.string().describe("The ID of the created app"),
+    revision: z.string().describe("The revision number of the created app"),
+};
+const toolName = "kintone-add-app";
+const toolConfig = {
+    title: "Add App",
+    description: "Create a new app in the pre-live environment on kintone. The pre-live environment is a temporary storage area where app information is saved before deployment. To reflect changes to the production environment, execute the kintone-deploy-app tool after this tool.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ name, space }, { client }) => {
+    const app = await client.app.addApp({ name, space });
+    const result = {
+        app: app.app,
+        revision: app.revision,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const addApp = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/app/add-form-fields.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+import { propertiesForParameterSchema } from "../../../schema/app/index.js";
+const inputSchema = {
+    app: z
+        .string()
+        .describe("The ID of the app to add fields to (numeric value as string)"),
+    properties: propertiesForParameterSchema.describe("Object containing field configurations to add"),
+    revision: z
+        .string()
+        .optional()
+        .describe("Expected app configuration revision number. If the specified revision number does not match the current app's revision, an error will occur and the update will not be performed. If not specified or set to '-1', the revision number will not be checked."),
+};
+const outputSchema = {
+    revision: z.string().describe("Updated app configuration revision number"),
+};
+const toolName = "kintone-add-form-fields";
+const toolConfig = {
+    title: "Add Form Fields",
+    description: "Add new fields to a kintone app (preview environment only). " +
+        "Requires App Management permissions. " +
+        "Field codes must be unique, max 128 chars, cannot start with numbers, and only '_' symbol allowed. " +
+        "For selection fields (DROP_DOWN/RADIO_BUTTON/CHECK_BOX/MULTI_SELECT), option keys must exactly match their label values. " +
+        "Options require 'label' and 'index' properties. " +
+        "For lookup fields, use appropriate field type (NUMBER for RECORD_NUMBER, SINGLE_LINE_TEXT for text fields). " +
+        "Use kintone-get-form-fields first to check existing fields. " +
+        "Changes require kintone-deploy-app to apply to live app.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ app, properties, revision }, { client }) => {
+    const response = await client.app.addFormFields({
+        app,
+        properties,
+        revision,
+    });
+    const result = {
+        revision: response.revision,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const addFormFields = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/app/delete-form-fields.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+const inputSchema = {
+    app: z
+        .string()
+        .describe("The ID of the app to delete form fields from (numeric value as string)"),
+    fields: z
+        .array(z.string())
+        .min(1, "At least one field code is required")
+        .max(100, "Maximum 100 fields can be deleted at once")
+        .describe("Array of field codes to delete"),
+    revision: z
+        .string()
+        .optional()
+        .describe("Expected app configuration revision number. If the specified revision number does not match the current app's revision, an error will occur and the update will not be performed. If not specified or set to '-1', the revision number will not be checked."),
+};
+const outputSchema = {
+    revision: z.string().describe("The new revision number after deletion"),
+};
+const toolName = "kintone-delete-form-fields";
+const toolConfig = {
+    title: "Delete Form Fields",
+    description: "Delete form fields from a kintone app (preview environment only). " +
+        "Maximum 100 fields can be deleted at once. " +
+        "Cannot delete status, assignee, or category fields. " +
+        "Useful for recreating lookup fields when updates fail. " +
+        "Use kintone-get-form-fields first to verify field codes. " +
+        "Changes require kintone-deploy-app to apply to live app.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ app, fields, revision }, { client }) => {
+    const response = (await client.app.deleteFormFields({
+        app,
+        fields,
+        revision,
+    }));
+    const result = {
+        revision: response.revision,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const deleteFormFields = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/app/deploy-app.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+const inputSchema = {
+    apps: z
+        .array(z.object({
+        app: z
+            .string()
+            .describe("The ID of the app to deploy (numeric value as string)"),
+        revision: z
+            .string()
+            .optional()
+            .describe("The expected revision number"),
+    }))
+        .min(1)
+        .max(300)
+        .describe("List of apps to deploy (minimum 1, maximum 300 apps)"),
+    revert: z
+        .boolean()
+        .optional()
+        .describe("If true, revert changes instead of deploying (default: false)"),
+};
+const outputSchema = {
+    message: z.string().describe("Deployment status message"),
+};
+const toolName = "kintone-deploy-app";
+const toolConfig = {
+    title: "Deploy App Settings",
+    description: "Deploy app settings from pre-live to production environment on kintone. " +
+        "This is an asynchronous API - use kintone-get-app-deploy-status tool to check deployment progress.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ apps, revert }, { client }) => {
+    await client.app.deployApp({ apps, revert });
+    const result = {
+        message: `Deployment initiated for ${apps.length} app(s). Use kintone-get-app-deploy-status tool to check progress.`,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const deployApp = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/app/get-form-fields.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { createTool } from "../../factory.js";
+import { propertiesForParameterSchema } from "../../../schema/app/index.js";
 const inputSchema = {
     app: z
         .string()
@@ -13,112 +14,20 @@ const inputSchema = {
         .optional()
         .describe("Whether to get form fields from pre-live environment"),
 };
-const fieldPropertySchema = z.object({
-    type: z.string().describe("The field type"),
-    code: z.string().describe("The field code"),
-    label: z.string().describe("The field name"),
-    enabled: z
-        .boolean()
-        .optional()
-        .describe("Whether the field is enabled (for STATUS and CATEGORY fields)"),
-    noLabel: z.boolean().optional().describe("Whether to hide the field name"),
-    required: z.boolean().optional().describe("Whether the field is required"),
-    unique: z.boolean().optional().describe("Whether the field must be unique"),
-    maxValue: z.string().optional().describe("Maximum value"),
-    minValue: z.string().optional().describe("Minimum value"),
-    maxLength: z.string().optional().describe("Maximum length"),
-    minLength: z.string().optional().describe("Minimum length"),
-    defaultValue: z.any().optional().describe("Default value"),
-    defaultNowValue: z
-        .boolean()
-        .optional()
-        .describe("Whether to use current date/time as default"),
-    entities: z
-        .array(z.object({
-        type: z.enum(["USER", "GROUP", "ORGANIZATION"]),
-        code: z.string(),
-    }))
-        .optional()
-        .describe("Default entities for user/group/organization selection fields"),
-    options: z
-        .record(z.object({
-        label: z.string(),
-        index: z.string(),
-    }))
-        .optional()
-        .describe("Options for selection fields"),
-    align: z
-        .enum(["HORIZONTAL", "VERTICAL"])
-        .optional()
-        .describe("Option alignment for radio/checkbox fields"),
-    expression: z.string().optional().describe("Calculation formula"),
-    hideExpression: z
-        .boolean()
-        .optional()
-        .describe("Whether to hide the formula"),
-    format: z.string().optional().describe("Display format"),
-    displayScale: z.string().optional().describe("Number of decimal places"),
-    unit: z.string().optional().describe("Unit symbol"),
-    unitPosition: z
-        .enum(["BEFORE", "AFTER"])
-        .optional()
-        .describe("Unit position"),
-    digit: z.boolean().optional().describe("Whether to use thousands separator"),
-    thumbnailSize: z.string().optional().describe("Image thumbnail size"),
-    protocol: z
-        .enum(["WEB", "CALL", "MAIL"])
-        .optional()
-        .describe("Link protocol"),
-    lookup: z
-        .object({
-        relatedApp: z.object({
-            app: z.string(),
-            code: z.string(),
-        }),
-        relatedKeyField: z.string(),
-        fieldMappings: z.array(z.object({
-            field: z.string(),
-            relatedField: z.string(),
-        })),
-        lookupPickerFields: z.array(z.string()),
-        filterCond: z.string().optional(),
-        sort: z.string().optional(),
-    })
-        .optional()
-        .describe("Lookup settings"),
-    referenceTable: z
-        .object({
-        relatedApp: z.object({
-            app: z.string(),
-            code: z.string(),
-        }),
-        condition: z.object({
-            field: z.string(),
-            relatedField: z.string(),
-        }),
-        filterCond: z.string().optional(),
-        displayFields: z.array(z.string()),
-        sort: z.string().optional(),
-        size: z.string().optional(),
-    })
-        .optional()
-        .describe("Related records settings"),
-    fields: z.record(z.any()).optional().describe("Fields in subtable"),
-    openGroup: z
-        .boolean()
-        .optional()
-        .describe("Whether the group is expanded by default"),
-});
 const outputSchema = {
-    properties: z
-        .record(fieldPropertySchema)
-        .describe("Object containing field configurations"),
+    properties: propertiesForParameterSchema.describe("Object containing field configurations"),
     revision: z.string().describe("App configuration revision number"),
 };
 const toolName = "kintone-get-form-fields";
 const toolConfig = {
     title: "Get Form Fields",
-    description: "Get form field settings from a kintone app",
+    description: "Get form field settings from a kintone app. " +
+        "Returns detailed field information including type, code, label, and all configuration settings " +
+        "(required status, default values, validation rules, options for selection fields, lookup configurations). " +
+        "Response includes 'properties' object with all fields and 'revision' string. " +
+        "Essential for understanding current field structure before add/update/delete operations. " +
+        "Use to verify lookup field configurations and field mappings. " +
+        "Supports both live and pre-live app settings retrieval.",
     inputSchema,
     outputSchema,
 };

package/dist/tools/kintone/app/get-form-layout.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { createTool } from "../../factory.js";
-import { layoutElementSchema } from "../../../schema/app/index.js";
+import { layoutForParameterSchema } from "../../../schema/app/index.js";
 const inputSchema = {
     app: z
         .string()
@@ -11,9 +11,7 @@ const inputSchema = {
         .describe("Whether to retrieve from preview environment (requires app administration permission for preview, record view/add permission for production)"),
 };
 const outputSchema = {
-    layout: z
-        .array(layoutElementSchema)
-        .describe("Array of layout elements (rows, subtables, groups)"),
+    layout: layoutForParameterSchema.describe("Array of layout elements (rows, subtables, groups)"),
     revision: z.string().describe("App configuration revision number"),
 };
 const callback = async ({ app, preview }, { client }) => {
@@ -37,7 +35,11 @@ const callback = async ({ app, preview }, { client }) => {
 };
 export const getFormLayout = createTool("kintone-get-form-layout", {
     title: "Get Form Layout",
-    description: "Get form layout from a kintone app",
+    description: "Get form layout from a kintone app. " +
+        "Returns layout structure with rows, subtables, groups, and field positioning. " +
+        "Use to understand current form arrangement before layout updates. " +
+        "Essential when adding new fields that need specific positioning or when rearranging existing fields. " +
+        "Supports both live and pre-live app settings retrieval.",
     inputSchema,
     outputSchema,
 }, callback);

package/dist/tools/kintone/app/update-form-fields.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+import { propertiesForParameterSchema } from "../../../schema/app/index.js";
+const inputSchema = {
+    app: z
+        .string()
+        .describe("The ID of the app to update form fields for (numeric value as string)"),
+    properties: propertiesForParameterSchema.describe("Object containing field configurations to update"),
+    revision: z
+        .string()
+        .optional()
+        .describe("Expected app configuration revision number. If the specified revision number does not match the current app's revision, an error will occur and the update will not be performed. If not specified or set to '-1', the revision number will not be checked."),
+};
+const outputSchema = {
+    revision: z.string().describe("Updated app configuration revision number"),
+};
+const toolName = "kintone-update-form-fields";
+const toolConfig = {
+    title: "Update Form Fields",
+    description: "Update form field settings in a kintone app (preview environment only). " +
+        "Requires App Management permissions. " +
+        "Cannot update field codes for Label, Blank space, Border, Status, Assignee, or Category fields. " +
+        "For selection fields, unspecified options will be deleted. " +
+        "Option keys must exactly match current option names. " +
+        "For lookup fields, existing lookup configurations may not update properly - consider deleting and recreating the field instead. " +
+        "Use kintone-get-form-fields first to check current settings. " +
+        "Changes require kintone-deploy-app to apply to live app.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ app, properties, revision }, { client }) => {
+    const response = await client.app.updateFormFields({
+        app,
+        properties: properties,
+        revision,
+    });
+    const result = {
+        revision: response.revision,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const updateFormFields = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/app/update-form-layout.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+import { layoutForParameterSchema } from "../../../schema/app/index.js";
+const inputSchema = {
+    app: z
+        .string()
+        .describe("The ID of the app to update form layout for (numeric value as string)"),
+    layout: layoutForParameterSchema.describe("Array of layout elements (rows, subtables, groups)"),
+    revision: z
+        .string()
+        .optional()
+        .describe("Expected app configuration revision number. If the specified revision number does not match the current app's revision, an error will occur and the update will not be performed. If not specified or set to '-1', the revision number will not be checked."),
+};
+const outputSchema = {
+    revision: z.string().describe("Updated app configuration revision number"),
+};
+const toolName = "kintone-update-form-layout";
+const toolConfig = {
+    title: "Update Form Layout",
+    description: "Update form layout settings in a kintone app (preview environment only). " +
+        "Use kintone-get-form-fields and kintone-get-form-layout first to understand current structure. " +
+        "Field codes are case-sensitive and must match exactly. " +
+        "For SUBTABLE fields, use nested structure: {type: 'SUBTABLE', code: 'table_code', fields: [{type: 'field_type', code: 'field_code'}, ...]}. " +
+        "Required when adding new fields to ensure proper positioning. " +
+        "Changes require kintone-deploy-app to apply to live app.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ app, layout, revision }, { client }) => {
+    const response = await client.app.updateFormLayout({
+        app,
+        layout,
+        revision,
+    });
+    const result = {
+        revision: response.revision,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const updateFormLayout = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/app/update-general-settings.js

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+const inputSchema = {
+    app: z
+        .string()
+        .describe("The ID of the app to update (numeric value as string)"),
+    name: z
+        .string()
+        .min(1)
+        .max(64)
+        .optional()
+        .describe("The app name (1-64 characters)"),
+    description: z
+        .string()
+        .max(10000)
+        .optional()
+        .describe("The app description (up to 10,000 characters)"),
+    icon: z
+        .discriminatedUnion("type", [
+        z.object({
+            type: z.literal("PRESET"),
+            key: z.string().describe("The icon key for PRESET type"),
+        }),
+        z.object({
+            type: z.literal("FILE"),
+            file: z
+                .object({
+                fileKey: z.string().describe("The file key for uploaded icon"),
+            })
+                .describe("The file information for FILE type"),
+        }),
+    ])
+        .optional()
+        .describe("The app icon configuration"),
+    theme: z
+        .enum(["WHITE", "RED", "GREEN", "BLUE", "YELLOW", "BLACK"])
+        .optional()
+        .describe("The design theme"),
+    titleField: z
+        .discriminatedUnion("selectionMode", [
+        z.object({
+            selectionMode: z.literal("AUTO"),
+        }),
+        z.object({
+            selectionMode: z.literal("MANUAL"),
+            code: z.string().describe("The field code for MANUAL selection mode"),
+        }),
+    ])
+        .optional()
+        .describe("The record title field settings"),
+    enableThumbnails: z
+        .boolean()
+        .optional()
+        .describe("Whether to enable thumbnail display"),
+    enableComments: z
+        .boolean()
+        .optional()
+        .describe("Whether to enable record comments"),
+    enableBulkDeletion: z
+        .boolean()
+        .optional()
+        .describe("Whether to enable bulk deletion of records"),
+    enableDuplicateRecord: z
+        .boolean()
+        .optional()
+        .describe("Whether to enable the reuse record feature"),
+    enableInlineRecordEditing: z
+        .boolean()
+        .optional()
+        .describe("Whether to enable inline editing in record list"),
+    numberPrecision: z
+        .object({
+        digits: z.string().optional().describe("Total number of digits (1-30)"),
+        decimalPlaces: z
+            .string()
+            .optional()
+            .describe("Number of decimal places (0-10)"),
+        roundingMode: z
+            .enum(["HALF_EVEN", "UP", "DOWN"])
+            .optional()
+            .describe("Rounding method"),
+    })
+        .optional()
+        .describe("The numeric calculation precision settings"),
+    firstMonthOfFiscalYear: z
+        .string()
+        .optional()
+        .describe("The first month of the fiscal year (1-12)"),
+    revision: z
+        .string()
+        .optional()
+        .describe("Expected revision number for optimistic locking"),
+};
+const outputSchema = {
+    revision: z.string().describe("The revision number after the update"),
+};
+const toolName = "kintone-update-general-settings";
+const toolConfig = {
+    title: "Update General Settings",
+    description: "Update the general settings of a kintone app. Changes are made to the pre-live environment, which is a temporary storage area where app information is saved before deployment. To reflect changes to the production environment, execute the kintone-deploy-app tool after this tool.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async (params, { client }) => {
+    const response = await client.app.updateAppSettings(params);
+    const result = {
+        revision: response.revision,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const updateGeneralSettings = createTool(toolName, toolConfig, callback);

package/dist/version.js

@@ -1,2 +1,2 @@
 // This file is auto-generated. Do not edit manually.
-export const version = "1.1.0"; // x-release-please-version
+export const version = "1.2.1"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kintone/mcp-server",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "The official MCP Server for kintone",
   "keywords": [
     "kintone",
@@ -30,7 +30,7 @@
     "dist"
   ],
   "dependencies": {
-    "@kintone/rest-api-client": "^5.7.4",
+    "@kintone/rest-api-client": "^5.7.5",
     "@modelcontextprotocol/sdk": "^1.17.5",
     "file-type": "^21.0.0",
     "https-proxy-agent": "^7.0.6",
@@ -41,15 +41,17 @@
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
     "@cybozu/eslint-config": "^24.2.0",
-    "@cybozu/license-manager": "^1.3.1",
-    "@types/node": "^22.18.1",
+    "@cybozu/license-manager": "^1.4.0",
+    "@modelcontextprotocol/inspector": "^0.17.0",
+    "@types/node": "^22.18.8",
     "doctoc": "^2.2.1",
-    "eslint": "^9.35.0",
-    "eslint-plugin-package-json": "^0.56.2",
-    "globals": "^16.3.0",
+    "eslint": "^9.37.0",
+    "eslint-plugin-package-json": "^0.56.3",
+    "globals": "^16.4.0",
+    "npm": "^11.6.1",
     "prettier": "^3.6.2",
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
     "vitest": "^3.2.4"
   },
   "engines": {
@@ -73,6 +75,8 @@
     "fix": "pnpm run \"/^fix:.*/\"",
     "fix:eslint": "pnpm lint:eslint --fix",
     "fix:prettier": "pnpm lint:prettier --write",
+    "inspector": "mcp-inspector node dist/index.js",
+    "inspector:dev": "mcp-inspector tsx src/index.ts",
     "license:analyze": "license-manager analyze -c license-manager.config.cjs",
     "license:extract": "license-manager extract -c license-manager.config.cjs -w .",
     "lint": "pnpm run \"/^lint:.*/\"",