@kintone/mcp-server 1.0.0 → 1.2.0

package/dist/tools/kintone/app/get-process-management.js

@@ -1,7 +1,5 @@
 import { z } from "zod";
-import { createTool } from "../../utils.js";
-import { getKintoneClient } from "../../../client.js";
-import { parseKintoneClientConfig } from "../../../config/index.js";
+import { createTool } from "../../factory.js";
 const inputSchema = {
     app: z
         .string()
@@ -10,6 +8,10 @@ const inputSchema = {
         .enum(["ja", "en", "zh", "default", "user"])
         .optional()
         .describe("The language for field names"),
+    preview: z
+        .boolean()
+        .optional()
+        .describe("Whether to get process management settings from pre-live environment"),
 };
 const entitySchema = z.object({
     type: z.enum([
@@ -64,17 +66,18 @@ const outputSchema = {
         .describe("Array containing action configurations"),
     revision: z.string().describe("App settings revision number"),
 };
-export const getProcessManagement = createTool("kintone-get-process-management", {
+const toolName = "kintone-get-process-management";
+const toolConfig = {
     title: "Get Process Management",
     description: "Get process management settings from a kintone app",
     inputSchema,
     outputSchema,
-}, async ({ app, lang }) => {
-    const config = parseKintoneClientConfig();
-    const client = getKintoneClient(config);
+};
+const callback = async ({ app, lang, preview }, { client }) => {
     const response = await client.app.getProcessManagement({
         app,
         lang,
+        preview,
     });
     return {
         structuredContent: response,
@@ -85,4 +88,5 @@ export const getProcessManagement = createTool("kintone-get-process-management",
             },
         ],
     };
-});
+};
+export const getProcessManagement = createTool(toolName, toolConfig, 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/tools/kintone/file/download-file.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { ensureDirectoryExists, generateFileName, generateFilePath, getFileTypeFromArrayBuffer, writeFileSyncWithoutOverwrite, } from "../../../lib/filesystem.js";
+import { createTool } from "../../factory.js";
+const inputSchema = {
+    fileKey: z
+        .string()
+        .describe("The unique file key to download (obtained from record retrieval or file upload)"),
+    fileName: z
+        .string()
+        .describe("The filename (without extension) to use when downloading to local storage. The extension will be automatically detected and added based on the file's MIME type"),
+};
+const outputSchema = {
+    filePath: z.string().describe("Absolute path to the downloaded file"),
+    mimeType: z.string().describe("MIME type of the downloaded file"),
+    fileSize: z.number().describe("File size in bytes"),
+};
+const toolName = "kintone-download-file";
+const toolConfig = {
+    title: "Download File from Kintone",
+    description: "Download a file from kintone using its fileKey and save it to the configured download directory. Returns the absolute path to the saved file. Requires KINTONE_ATTACHMENTS_DIR environment variable to be set, app record viewing permission, and permission to view the field containing the file.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ fileKey, fileName }, { client, attachmentsDir }) => {
+    // Check if download directory is configured
+    if (!attachmentsDir) {
+        throw new Error("KINTONE_ATTACHMENTS_DIR environment variable must be set to use file download feature");
+    }
+    const buffer = await client.file.downloadFile({ fileKey });
+    ensureDirectoryExists(attachmentsDir);
+    const fileTypeResult = await getFileTypeFromArrayBuffer(buffer);
+    const filePath = generateFilePath(attachmentsDir, generateFileName(fileName, fileTypeResult?.ext));
+    writeFileSyncWithoutOverwrite(filePath, buffer);
+    const result = {
+        filePath,
+        mimeType: fileTypeResult?.mime || "application/octet-stream",
+        fileSize: buffer.byteLength,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const downloadFile = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/record/add-records.js

@@ -1,8 +1,6 @@
 import { z } from "zod";
-import { createTool } from "../../utils.js";
-import { getKintoneClient } from "../../../client.js";
-import { parseKintoneClientConfig } from "../../../config/index.js";
-import { recordSchemaForParameterWithoutFile } from "../../../schema/record/record-for-parameter.js";
+import { createTool } from "../../factory.js";
+import { recordSchemaForParameterWithoutFile } from "../../../schema/record/index.js";
 const inputSchema = {
     app: z
         .string()
@@ -19,14 +17,14 @@ const outputSchema = {
         .array(z.string())
         .describe("Array of revision numbers of the created records"),
 };
-export const addRecords = createTool("kintone-add-records", {
+const toolName = "kintone-add-records";
+const toolConfig = {
     title: "Add Records",
     description: "Add multiple records to a kintone app. Use kintone-get-form-fields tool first to discover available field codes and their required formats. Note: Some fields cannot be registered (LOOKUP copies, STATUS, CATEGORY, CALC, ASSIGNEE, auto-calculated fields).",
     inputSchema,
     outputSchema,
-}, async ({ app, records }) => {
-    const config = parseKintoneClientConfig();
-    const client = getKintoneClient(config);
+};
+const callback = async ({ app, records }, { client }) => {
     const response = await client.record.addRecords({
         app,
         records,
@@ -44,4 +42,5 @@ export const addRecords = createTool("kintone-add-records", {
             },
         ],
     };
-});
+};
+export const addRecords = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/record/delete-records.js

@@ -1,7 +1,5 @@
 import { z } from "zod";
-import { createTool } from "../../utils.js";
-import { getKintoneClient } from "../../../client.js";
-import { parseKintoneClientConfig } from "../../../config/index.js";
+import { createTool } from "../../factory.js";
 const inputSchema = {
     app: z.string().describe("The ID of the app (numeric value as string)"),
     ids: z
@@ -15,17 +13,18 @@ const inputSchema = {
         .describe("Array of expected revision numbers for each record (numeric values as strings). If specified, must have the same length as ids array. Deletion will fail if current revisions don't match. Specify -1 or omit to skip revision validation."),
 };
 const outputSchema = {};
-export const deleteRecords = createTool("kintone-delete-records", {
+const toolName = "kintone-delete-records";
+const toolConfig = {
     title: "Delete Records",
     description: "Delete multiple records from a kintone app. Maximum 100 records can be deleted at once.",
     inputSchema,
     outputSchema,
-}, async ({ app, ids, revisions }) => {
-    const config = parseKintoneClientConfig();
-    const client = getKintoneClient(config);
+};
+const callback = async ({ app, ids, revisions }, { client }) => {
     await client.record.deleteRecords({ app, ids, revisions });
     return {
         structuredContent: {},
         content: [],
     };
-});
+};
+export const deleteRecords = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/record/get-records.js

@@ -1,8 +1,6 @@
 import { z } from "zod";
-import { createTool } from "../../utils.js";
-import { getKintoneClient } from "../../../client.js";
-import { parseKintoneClientConfig } from "../../../config/index.js";
-import { recordSchema } from "../../../schema/record/records.js";
+import { createTool } from "../../factory.js";
+import { recordSchema } from "../../../schema/record/index.js";
 const filtersSchema = z
     .object({
     textContains: z
@@ -121,14 +119,14 @@ function buildQueryFromFilters(filters) {
     });
     return conditions.length > 0 ? conditions.join(" and ") : undefined;
 }
-export const getRecords = createTool("kintone-get-records", {
+const toolName = "kintone-get-records";
+const toolConfig = {
     title: "Get Records",
     description: "Get multiple records from a kintone app with structured filtering. Use kintone-get-form-fields tool first to discover available fields and their types.",
     inputSchema,
     outputSchema,
-}, async ({ app, filters, fields, orderBy, limit, offset }) => {
-    const config = parseKintoneClientConfig();
-    const client = getKintoneClient(config);
+};
+const callback = async ({ app, filters, fields, orderBy, limit, offset }, { client }) => {
     let query = filters ? buildQueryFromFilters(filters) : undefined;
     if (orderBy && orderBy.length > 0) {
         const orderClauses = orderBy
@@ -163,4 +161,5 @@ export const getRecords = createTool("kintone-get-records", {
             },
         ],
     };
-});
+};
+export const getRecords = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/record/update-records.js

@@ -1,8 +1,6 @@
 import { z } from "zod";
-import { createTool } from "../../utils.js";
-import { getKintoneClient } from "../../../client.js";
-import { parseKintoneClientConfig } from "../../../config/index.js";
-import { recordSchemaForParameter } from "../../../schema/record/record-for-parameter.js";
+import { createTool } from "../../factory.js";
+import { recordSchemaForParameter } from "../../../schema/record/index.js";
 const updateRecordSchema = z.object({
     // updateKey指定は対象外
     id: z.string().describe("Record ID to update (numeric value as string)"),
@@ -30,14 +28,14 @@ const outputSchema = {
     }))
         .describe("Array of updated record information"),
 };
-export const updateRecords = createTool("kintone-update-records", {
+const toolName = "kintone-update-records";
+const toolConfig = {
     title: "Update Records",
     description: "Update multiple records in a kintone app. Use kintone-get-form-fields tool first to discover available field codes and their required formats. Note: Some fields cannot be updated (LOOKUP copies, STATUS, CATEGORY, CALC, ASSIGNEE, auto-calculated fields).",
     inputSchema,
     outputSchema,
-}, async ({ app, records }) => {
-    const config = parseKintoneClientConfig();
-    const client = getKintoneClient(config);
+};
+const callback = async ({ app, records }, { client }) => {
     const response = await client.record.updateRecords({
         app,
         records,
@@ -55,4 +53,5 @@ export const updateRecords = createTool("kintone-update-records", {
             },
         ],
     };
-});
+};
+export const updateRecords = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/record/update-statuses.js

@@ -1,7 +1,5 @@
 import { z } from "zod";
-import { createTool } from "../../utils.js";
-import { getKintoneClient } from "../../../client.js";
-import { parseKintoneClientConfig } from "../../../config/index.js";
+import { createTool } from "../../factory.js";
 const statusRecordSchema = z.object({
     id: z.string().describe("Record ID (numeric value as string)"),
     action: z
@@ -34,14 +32,14 @@ const outputSchema = {
     }))
         .describe("Array of updated record information"),
 };
-export const updateStatuses = createTool("kintone-update-statuses", {
+const toolName = "kintone-update-statuses";
+const toolConfig = {
     title: "Update Statuses",
     description: "Update status of multiple records in a kintone app. Requires process management feature to be enabled. Maximum 100 records can be updated at once.",
     inputSchema,
     outputSchema,
-}, async ({ app, records }) => {
-    const config = parseKintoneClientConfig();
-    const client = getKintoneClient(config);
+};
+const callback = async ({ app, records }, { client }) => {
     const response = await client.record.updateRecordsStatus({
         app,
         records,
@@ -58,4 +56,5 @@ export const updateStatuses = createTool("kintone-update-statuses", {
             },
         ],
     };
-});
+};
+export const updateStatuses = createTool(toolName, toolConfig, callback);

package/dist/tools/types/tool.js

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kintone/mcp-server",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "The official MCP Server for kintone",
   "keywords": [
     "kintone",
@@ -31,7 +31,8 @@
   ],
   "dependencies": {
     "@kintone/rest-api-client": "^5.7.4",
-    "@modelcontextprotocol/sdk": "^1.17.4",
+    "@modelcontextprotocol/sdk": "^1.17.5",
+    "file-type": "^21.0.0",
     "https-proxy-agent": "^7.0.6",
     "zod": "^3.25.76"
   },
@@ -41,11 +42,13 @@
     "@commitlint/config-conventional": "^19.8.1",
     "@cybozu/eslint-config": "^24.2.0",
     "@cybozu/license-manager": "^1.3.1",
-    "@types/node": "^22.18.0",
+    "@modelcontextprotocol/inspector": "^0.16.8",
+    "@types/node": "^22.18.4",
     "doctoc": "^2.2.1",
-    "eslint": "^9.34.0",
-    "eslint-plugin-package-json": "^0.56.0",
-    "globals": "^16.3.0",
+    "eslint": "^9.35.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",
@@ -72,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:.*/\"",

package/dist/server.js

@@ -1,20 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { tools } from "./tools/index.js";
-import { version } from "./version.js";
-import { PACKAGE_NAME, parseKintoneClientConfig } from "./config/index.js";
-import { shouldEnableTool } from "./tool-filters.js";
-export const createServer = () => {
-    const server = new McpServer({
-        name: PACKAGE_NAME,
-        version,
-    }, {
-        capabilities: {
-            tools: {},
-        },
-    });
-    const config = parseKintoneClientConfig();
-    tools
-        .filter((tool) => shouldEnableTool(tool.name, config))
-        .forEach((tool) => server.registerTool(tool.name, tool.config, tool.callback));
-    return server;
-};

package/dist/tool-filters.js

@@ -1,14 +0,0 @@
-export const filterRules = [
-    {
-        condition: (config) => config.isApiTokenAuth,
-        excludeTools: ["kintone-get-apps"],
-    },
-];
-export function shouldEnableTool(toolName, config) {
-    for (const rule of filterRules) {
-        if (rule.condition(config) && rule.excludeTools.includes(toolName)) {
-            return false;
-        }
-    }
-    return true;
-}

package/dist/tools/utils.js

@@ -1,8 +0,0 @@
-// Tool creation helper function
-export function createTool(name, config, callback) {
-    return {
-        name,
-        config,
-        callback,
-    };
-}