@kintone/mcp-server 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.1.0](https://github.com/kintone/mcp-server/compare/1.0.0...1.1.0) (2025-09-18)
+
+
+### Features
+
+* add the tool for downloading file ([#80](https://github.com/kintone/mcp-server/issues/80)) ([6cead9e](https://github.com/kintone/mcp-server/commit/6cead9ed1891a4ce0aa26978a52dd7df27e195ff))
+* add tools for get app settings ([#114](https://github.com/kintone/mcp-server/issues/114)) ([470e755](https://github.com/kintone/mcp-server/commit/470e75555cfeef9fbf582aab504e24528c3f94cd))
+* supports preview ([#112](https://github.com/kintone/mcp-server/issues/112)) ([3bb032e](https://github.com/kintone/mcp-server/commit/3bb032e00bd0532cac832dbdd9fc6aec1e7255d8))
+
+
+### Bug Fixes
+
+* **deps:** update dependency @modelcontextprotocol/sdk to ^1.17.5 ([#100](https://github.com/kintone/mcp-server/issues/100)) ([ad8ce6e](https://github.com/kintone/mcp-server/commit/ad8ce6e2557c4ccbf10f2d0895ceaebbde3d5083))
+
 ## [1.0.0](https://github.com/kintone/mcp-server/compare/0.1.0...1.0.0) (2025-08-27)
 
 

package/README.md

@@ -7,7 +7,7 @@
 
 [ci-badge]: https://github.com/kintone/mcp-server/actions/workflows/ci.yaml/badge.svg
 [ci-url]: https://github.com/kintone/mcp-server/actions/workflows/ci.yaml
-[npm-badge]: https://badge.fury.io/js/@kintone%2Fmcp-server.svg
+[npm-badge]: https://badge.fury.io/js/@kintone%2Fmcp-server.svg?icon=si%3Anpm
 [npm-url]: https://badge.fury.io/js/@kintone%2Fmcp-server
 [license-badge]: https://img.shields.io/badge/License-Apache_2.0-blue.svg
 [license-url]: LICENSE
@@ -160,6 +160,7 @@ DXTファイルをインストールした場合、追加の手順は必要あ
 | `--pfx-file-path`       | `KINTONE_PFX_FILE_PATH`       | PFXファイルのパス（クライアント証明書認証用）              | -    |
 | `--pfx-file-password`   | `KINTONE_PFX_FILE_PASSWORD`   | PFXファイルのパスワード                                    | -    |
 | `--proxy`               | `HTTPS_PROXY`                 | HTTPSプロキシのURL（例: `http://proxy.example.com:8080`）  | -    |
+| `--attachments-dir`     | `KINTONE_ATTACHMENTS_DIR`     | ダウンロードしたファイルの保存先                           | -    |
 
 ※1: `KINTONE_USERNAME` & `KINTONE_PASSWORD` または `KINTONE_API_TOKEN` のいずれかが必須
 
@@ -183,22 +184,34 @@ export HTTPS_PROXY="http://username:password@proxy.example.com:8080"
 
 ## ツール一覧
 
-| ツール名                         | 説明                             |
-| -------------------------------- | -------------------------------- |
-| `kintone-get-apps`               | 複数のアプリ情報を取得           |
-| `kintone-get-app`                | 単一アプリの詳細情報を取得       |
-| `kintone-get-form-fields`        | アプリのフィールド設定を取得     |
-| `kintone-get-process-management` | プロセス管理設定を取得           |
-| `kintone-get-records`            | 複数のレコードを取得             |
-| `kintone-add-records`            | 複数のレコードを追加             |
-| `kintone-update-records`         | 複数のレコードを更新             |
-| `kintone-delete-records`         | 複数のレコードを削除             |
-| `kintone-update-statuses`        | 複数のレコードのステータスを更新 |
+| ツール名                         | 説明                                   |
+| -------------------------------- | -------------------------------------- |
+| `kintone-get-apps`               | 複数のアプリ情報を取得                 |
+| `kintone-get-app`                | 単一アプリの詳細情報を取得             |
+| `kintone-get-form-fields`        | アプリのフィールド設定を取得           |
+| `kintone-get-form-layout`        | アプリのフォームレイアウトを取得       |
+| `kintone-get-process-management` | プロセス管理設定を取得                 |
+| `kintone-get-app-deploy-status`  | アプリ設定の運用環境への反映状況確認   |
+| `kintone-get-general-settings`   | アプリの一般設定を取得                 |
+| `kintone-get-records`            | 複数のレコードを取得                   |
+| `kintone-add-records`            | 複数のレコードを追加                   |
+| `kintone-update-records`         | 複数のレコードを更新                   |
+| `kintone-delete-records`         | 複数のレコードを削除                   |
+| `kintone-update-statuses`        | 複数のレコードのステータスを更新       |
+| `kintone-download-file`          | 添付ファイルフィールドのファイルを保存 |
 
 ## ドキュメント
 
 - [認証設定ガイド](./docs/ja/authentication.md) - 認証方法の詳細と設定例
 
+## 使用上の注意
+
+### `kintone-download-file`ツールの注意点
+
+- ダウンロードしたファイルは、`--attachments-dir`または`KINTONE_ATTACHMENTS_DIR`で指定したディレクトリに保存されます。
+- `--attachments-dir`または`KINTONE_ATTACHMENTS_DIR`を指定しない場合はツール実行時にエラーになります。
+- `--attachments-dir`または`KINTONE_ATTACHMENTS_DIR`に存在しないディレクトリを指定した場合は、ディレクトリを新規作成してからそこに保存されます。
+
 ## 制限事項
 
 ### レコード操作の制限
@@ -209,7 +222,6 @@ export HTTPS_PROXY="http://username:password@proxy.example.com:8080"
 ### その他の制限
 
 - **ゲストスペースに非対応**: ゲストスペース内のアプリにはアクセスできません
-- **動作テスト環境に非対応**: アプリの動作テスト環境（アプリ設定を本番環境に反映する前に検証できる環境）は利用できません
 
 ## サポート方針
 

package/dist/{client.js → client/index.js}

@@ -1,20 +1,17 @@
 import { KintoneRestAPIClient } from "@kintone/rest-api-client";
-import { PACKAGE_NAME, } from "./config/index.js";
 import { HttpsProxyAgent } from "https-proxy-agent";
 import { Agent } from "https";
 import { readFileSync } from "fs";
-import { version } from "./version.js";
 let client = null;
 export const getKintoneClient = (config) => {
     if (client) {
         return client;
     }
-    const { KINTONE_BASE_URL, KINTONE_USERNAME, KINTONE_PASSWORD, KINTONE_API_TOKEN, KINTONE_BASIC_AUTH_USERNAME, KINTONE_BASIC_AUTH_PASSWORD, HTTPS_PROXY, KINTONE_PFX_FILE_PATH, KINTONE_PFX_FILE_PASSWORD, } = config.config;
+    const { KINTONE_BASE_URL, KINTONE_USERNAME, KINTONE_PASSWORD, KINTONE_API_TOKEN, KINTONE_BASIC_AUTH_USERNAME, KINTONE_BASIC_AUTH_PASSWORD, HTTPS_PROXY, KINTONE_PFX_FILE_PATH, KINTONE_PFX_FILE_PASSWORD, USER_AGENT, } = config;
     const authParams = buildAuthParams({
         username: KINTONE_USERNAME,
         password: KINTONE_PASSWORD,
         apiToken: KINTONE_API_TOKEN,
-        isApiTokenAuth: config.isApiTokenAuth,
     });
     client = new KintoneRestAPIClient({
         baseUrl: KINTONE_BASE_URL,
@@ -23,7 +20,7 @@ export const getKintoneClient = (config) => {
             basicAuthUsername: KINTONE_BASIC_AUTH_USERNAME,
             basicAuthPassword: KINTONE_BASIC_AUTH_PASSWORD,
         }),
-        userAgent: `${PACKAGE_NAME}@${version}`,
+        userAgent: USER_AGENT,
         httpsAgent: buildHttpsAgent({
             proxy: HTTPS_PROXY,
             pfxFilePath: KINTONE_PFX_FILE_PATH,
@@ -32,11 +29,9 @@ export const getKintoneClient = (config) => {
     });
     return client;
 };
-export const resetKintoneClient = () => {
-    client = null;
-};
 const buildAuthParams = (option) => {
-    return option.isApiTokenAuth
+    const isApiTokenAuth = !(option.username && option.password) && !!option.apiToken;
+    return isApiTokenAuth
         ? { auth: { apiToken: option.apiToken } }
         : { auth: { username: option.username, password: option.password } };
 };

package/dist/client/types/client.js

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

package/dist/config/command-line.js

@@ -5,7 +5,7 @@ import { parseArgs } from "node:util";
  * （process.argv[0]はnode、[1]はスクリプトパスなので除外されます）
  * @param args process.argv で取得した値
  */
-export const parseCommandLineOptions = (args) => {
+export const parse = (args) => {
     const { values } = parseArgs({
         args: args.slice(2), // process.argv[0]はnode、[1]はスクリプトパスなので除外
         allowPositionals: true,
@@ -19,6 +19,7 @@ export const parseCommandLineOptions = (args) => {
             "pfx-file-path": { type: "string" },
             "pfx-file-password": { type: "string" },
             proxy: { type: "string" },
+            "attachments-dir": { type: "string" },
         },
     });
     return values;

package/dist/config/index.js

@@ -1,66 +1,34 @@
-import { configSchema, } from "./schema.js";
-import { parseCommandLineOptions } from "./command-line.js";
-export { PACKAGE_NAME, } from "./schema.js";
-export { parseCommandLineOptions } from "./command-line.js";
-export const mergeEnvironmentAndCommandLine = (env, args) => {
-    // 同等の変数の指定があればコマンドライン引数を優先
+import { version } from "../version.js";
+import { parseKintoneMcpServerConfig } from "./parser.js";
+import { PACKAGE_NAME } from "./schema.js";
+const config = parseKintoneMcpServerConfig();
+export const getMcpServerConfig = () => {
     return {
-        KINTONE_BASE_URL: args["base-url"] ?? env.KINTONE_BASE_URL,
-        KINTONE_USERNAME: args.username ?? env.KINTONE_USERNAME,
-        KINTONE_PASSWORD: args.password ?? env.KINTONE_PASSWORD,
-        KINTONE_API_TOKEN: args["api-token"] ?? env.KINTONE_API_TOKEN,
-        KINTONE_BASIC_AUTH_USERNAME: args["basic-auth-username"] ?? env.KINTONE_BASIC_AUTH_USERNAME,
-        KINTONE_BASIC_AUTH_PASSWORD: args["basic-auth-password"] ?? env.KINTONE_BASIC_AUTH_PASSWORD,
-        KINTONE_PFX_FILE_PATH: args["pfx-file-path"] ?? env.KINTONE_PFX_FILE_PATH,
-        KINTONE_PFX_FILE_PASSWORD: args["pfx-file-password"] ?? env.KINTONE_PFX_FILE_PASSWORD,
-        HTTPS_PROXY: args.proxy ?? env.HTTPS_PROXY ?? env.https_proxy,
+        name: PACKAGE_NAME,
+        version: version,
     };
 };
-export const parseKintoneClientConfig = () => {
-    const cmdArgs = parseCommandLineOptions(process.argv);
-    const mergedConfig = mergeEnvironmentAndCommandLine(process.env, cmdArgs);
-    const result = configSchema.safeParse(mergedConfig);
-    if (result.success) {
-        const data = result.data;
-        const isApiTokenAuth = !(data.KINTONE_USERNAME && data.KINTONE_PASSWORD) &&
-            !!data.KINTONE_API_TOKEN;
-        return {
-            config: data,
-            isApiTokenAuth,
-        };
-    }
-    const errors = result.error.format();
-    const errorMessages = [];
-    if (errors.KINTONE_BASE_URL?._errors.length) {
-        errorMessages.push(`KINTONE_BASE_URL: ${errors.KINTONE_BASE_URL._errors.join(", ")}`);
-    }
-    if (errors.KINTONE_USERNAME?._errors.length) {
-        errorMessages.push(`KINTONE_USERNAME: ${errors.KINTONE_USERNAME._errors.join(", ")}`);
-    }
-    if (errors.KINTONE_PASSWORD?._errors.length) {
-        errorMessages.push(`KINTONE_PASSWORD: ${errors.KINTONE_PASSWORD._errors.join(", ")}`);
-    }
-    if (errors.KINTONE_API_TOKEN?._errors.length) {
-        errorMessages.push(`KINTONE_API_TOKEN: ${errors.KINTONE_API_TOKEN._errors.join(", ")}`);
-    }
-    if (errors.HTTPS_PROXY?._errors.length) {
-        errorMessages.push(`HTTPS_PROXY: ${errors.HTTPS_PROXY._errors.join(", ")}`);
-    }
-    if (errors.KINTONE_PFX_FILE_PATH?._errors.length) {
-        errorMessages.push(`KINTONE_PFX_FILE_PATH: ${errors.KINTONE_PFX_FILE_PATH._errors.join(", ")}`);
-    }
-    if (errors.KINTONE_PFX_FILE_PASSWORD?._errors.length) {
-        errorMessages.push(`KINTONE_PFX_FILE_PASSWORD: ${errors.KINTONE_PFX_FILE_PASSWORD._errors.join(", ")}`);
-    }
-    if (errors.KINTONE_BASIC_AUTH_USERNAME?._errors.length) {
-        errorMessages.push(`KINTONE_BASIC_AUTH_USERNAME: ${errors.KINTONE_BASIC_AUTH_USERNAME._errors.join(", ")}`);
-    }
-    if (errors.KINTONE_BASIC_AUTH_PASSWORD?._errors.length) {
-        errorMessages.push(`KINTONE_BASIC_AUTH_PASSWORD: ${errors.KINTONE_BASIC_AUTH_PASSWORD._errors.join(", ")}`);
-    }
-    // Handle cross-field validation errors
-    if (errors._errors?.length) {
-        errorMessages.push(...errors._errors);
-    }
-    throw new Error(`Environment variables are missing or invalid:\n${errorMessages.join("\n")}`);
+export const getKintoneClientConfig = () => {
+    return {
+        KINTONE_BASE_URL: config.config.KINTONE_BASE_URL,
+        KINTONE_USERNAME: config.config.KINTONE_USERNAME,
+        KINTONE_PASSWORD: config.config.KINTONE_PASSWORD,
+        KINTONE_API_TOKEN: config.config.KINTONE_API_TOKEN,
+        KINTONE_BASIC_AUTH_USERNAME: config.config.KINTONE_BASIC_AUTH_USERNAME,
+        KINTONE_BASIC_AUTH_PASSWORD: config.config.KINTONE_BASIC_AUTH_PASSWORD,
+        HTTPS_PROXY: config.config.HTTPS_PROXY,
+        KINTONE_PFX_FILE_PATH: config.config.KINTONE_PFX_FILE_PATH,
+        KINTONE_PFX_FILE_PASSWORD: config.config.KINTONE_PFX_FILE_PASSWORD,
+        USER_AGENT: config.userAgent,
+    };
+};
+export const getToolConditionConfig = () => {
+    return {
+        isApiTokenAuth: config.isApiTokenAuth,
+    };
+};
+export const getFileConfig = () => {
+    return {
+        attachmentsDir: config.config.KINTONE_ATTACHMENTS_DIR,
+    };
 };

package/dist/config/parser.js

@@ -0,0 +1,72 @@
+import { parse } from "./command-line.js";
+import { PACKAGE_NAME, configSchema } from "./schema.js";
+import { version } from "../version.js";
+export const parseKintoneMcpServerConfig = () => {
+    const cmdArgs = parse(process.argv);
+    const mergedConfig = merge(process.env, cmdArgs);
+    const result = configSchema.safeParse(mergedConfig);
+    if (result.success) {
+        const data = result.data;
+        const isApiTokenAuth = !(data.KINTONE_USERNAME && data.KINTONE_PASSWORD) &&
+            !!data.KINTONE_API_TOKEN;
+        return {
+            config: data,
+            userAgent: `${PACKAGE_NAME}@${version}`,
+            isApiTokenAuth,
+        };
+    }
+    const errorMessages = createErrorMessage(result.error.format());
+    throw new Error(`Environment variables are missing or invalid:\n${errorMessages.join("\n")}`);
+};
+export const merge = (env, args) => {
+    return {
+        KINTONE_BASE_URL: args["base-url"] ?? env.KINTONE_BASE_URL,
+        KINTONE_USERNAME: args.username ?? env.KINTONE_USERNAME,
+        KINTONE_PASSWORD: args.password ?? env.KINTONE_PASSWORD,
+        KINTONE_API_TOKEN: args["api-token"] ?? env.KINTONE_API_TOKEN,
+        KINTONE_BASIC_AUTH_USERNAME: args["basic-auth-username"] ?? env.KINTONE_BASIC_AUTH_USERNAME,
+        KINTONE_BASIC_AUTH_PASSWORD: args["basic-auth-password"] ?? env.KINTONE_BASIC_AUTH_PASSWORD,
+        KINTONE_PFX_FILE_PATH: args["pfx-file-path"] ?? env.KINTONE_PFX_FILE_PATH,
+        KINTONE_PFX_FILE_PASSWORD: args["pfx-file-password"] ?? env.KINTONE_PFX_FILE_PASSWORD,
+        HTTPS_PROXY: args.proxy ?? env.HTTPS_PROXY ?? env.https_proxy,
+        KINTONE_ATTACHMENTS_DIR: args["attachments-dir"] ?? env.KINTONE_ATTACHMENTS_DIR,
+    };
+};
+const createErrorMessage = (errors) => {
+    const errorMessages = [];
+    if (errors.KINTONE_BASE_URL?._errors.length) {
+        errorMessages.push(`KINTONE_BASE_URL: ${errors.KINTONE_BASE_URL._errors.join(", ")}`);
+    }
+    if (errors.KINTONE_USERNAME?._errors.length) {
+        errorMessages.push(`KINTONE_USERNAME: ${errors.KINTONE_USERNAME._errors.join(", ")}`);
+    }
+    if (errors.KINTONE_PASSWORD?._errors.length) {
+        errorMessages.push(`KINTONE_PASSWORD: ${errors.KINTONE_PASSWORD._errors.join(", ")}`);
+    }
+    if (errors.KINTONE_API_TOKEN?._errors.length) {
+        errorMessages.push(`KINTONE_API_TOKEN: ${errors.KINTONE_API_TOKEN._errors.join(", ")}`);
+    }
+    if (errors.HTTPS_PROXY?._errors.length) {
+        errorMessages.push(`HTTPS_PROXY: ${errors.HTTPS_PROXY._errors.join(", ")}`);
+    }
+    if (errors.KINTONE_PFX_FILE_PATH?._errors.length) {
+        errorMessages.push(`KINTONE_PFX_FILE_PATH: ${errors.KINTONE_PFX_FILE_PATH._errors.join(", ")}`);
+    }
+    if (errors.KINTONE_PFX_FILE_PASSWORD?._errors.length) {
+        errorMessages.push(`KINTONE_PFX_FILE_PASSWORD: ${errors.KINTONE_PFX_FILE_PASSWORD._errors.join(", ")}`);
+    }
+    if (errors.KINTONE_BASIC_AUTH_USERNAME?._errors.length) {
+        errorMessages.push(`KINTONE_BASIC_AUTH_USERNAME: ${errors.KINTONE_BASIC_AUTH_USERNAME._errors.join(", ")}`);
+    }
+    if (errors.KINTONE_BASIC_AUTH_PASSWORD?._errors.length) {
+        errorMessages.push(`KINTONE_BASIC_AUTH_PASSWORD: ${errors.KINTONE_BASIC_AUTH_PASSWORD._errors.join(", ")}`);
+    }
+    if (errors.KINTONE_ATTACHMENTS_DIR?._errors.length) {
+        errorMessages.push(`KINTONE_ATTACHMENTS_DIR: ${errors.KINTONE_ATTACHMENTS_DIR._errors.join(", ")}`);
+    }
+    // Handle cross-field validation errors
+    if (errors._errors?.length) {
+        errorMessages.push(...errors._errors.map(String));
+    }
+    return errorMessages;
+};

package/dist/config/schema.js

@@ -50,6 +50,10 @@ export const configSchema = z
         .string()
         .optional()
         .describe("Password for PFX client certificate file"),
+    KINTONE_ATTACHMENTS_DIR: z
+        .string()
+        .optional()
+        .describe("Directory path for downloading files from kintone"),
 })
     .refine((data) => {
     // Either username/password or API token must be provided

package/dist/config/types/config.js

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

package/dist/index.js

@@ -1,14 +1,24 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createServer } from "./server.js";
-import { parseKintoneClientConfig } from "./config/index.js";
-import { getKintoneClient } from "./client.js";
+import { createServer } from "./server/index.js";
+import { getFileConfig, getKintoneClientConfig, getMcpServerConfig, getToolConditionConfig, } from "./config/index.js";
 const main = async () => {
     const transport = new StdioServerTransport();
     console.error("Starting server...");
-    const config = parseKintoneClientConfig();
-    getKintoneClient(config);
-    const server = createServer();
+    const mcpServerConfig = getMcpServerConfig();
+    const clientConfig = getKintoneClientConfig();
+    const fileConfig = getFileConfig();
+    const toolConditionConfig = getToolConditionConfig();
+    const serverConfig = {
+        name: mcpServerConfig.name,
+        version: mcpServerConfig.version,
+        config: {
+            clientConfig,
+            fileConfig,
+            toolConditionConfig,
+        },
+    };
+    const server = createServer(serverConfig);
     await server.connect(transport);
 };
 main().catch(console.error);

package/dist/lib/filesystem.js

@@ -0,0 +1,47 @@
+import { fileTypeFromBuffer } from "file-type";
+import fs from "node:fs";
+import path from "node:path";
+export const generateFileName = (fileName, ext) => {
+    const extWithDot = ext ? `.${ext}` : "";
+    return `${replaceSpecialCharacters(fileName)}${extWithDot}`;
+};
+export const generateFilePath = (downloadDir, filename) => {
+    const filePath = path.join(downloadDir, filename);
+    return filePath;
+};
+/**
+ * Replace special characters in filename for Windows compatibility
+ */
+const replaceSpecialCharacters = (filename) => {
+    // Windows forbidden characters: < > : " | ? * \ /
+    return filename.replace(/[<>:"|?*\\/]/g, "_");
+};
+/**
+ * Ensure directory exists, create if it doesn't
+ */
+export const ensureDirectoryExists = (dirPath) => {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+};
+export const writeFileSyncWithoutOverwrite = (filePath, arrayBuffer) => {
+    const buffer = Buffer.from(arrayBuffer);
+    const uniqueFilePath = generateUniqueLocalFilePath(filePath);
+    fs.writeFileSync(uniqueFilePath, buffer);
+};
+export const getFileTypeFromArrayBuffer = async (arrayBuffer) => {
+    return fileTypeFromBuffer(arrayBuffer);
+};
+const generateUniqueLocalFilePath = (filePath) => {
+    const internal = (index) => {
+        const newFileName = index === 0
+            ? path.basename(filePath)
+            : `${path.basename(filePath, path.extname(filePath))} (${index})${path.extname(filePath)}`;
+        const newFilePath = path.join(path.dirname(filePath), newFileName);
+        if (fs.existsSync(newFilePath)) {
+            return internal(index + 1);
+        }
+        return newFilePath;
+    };
+    return internal(0);
+};

package/dist/schema/app/form-layout.js

@@ -0,0 +1,101 @@
+import { z } from "zod";
+// All field types that have a 'code' property
+const fieldTypesWithCode = z.union([
+    z.literal("SINGLE_LINE_TEXT").describe("文字列（1行）"),
+    z.literal("MULTI_LINE_TEXT").describe("文字列（複数行）"),
+    z.literal("NUMBER").describe("数値"),
+    z.literal("CALC").describe("計算"),
+    z.literal("CHECK_BOX").describe("チェックボックス"),
+    z.literal("RADIO_BUTTON").describe("ラジオボタン"),
+    z.literal("DROP_DOWN").describe("ドロップダウン"),
+    z.literal("MULTI_SELECT").describe("複数選択"),
+    z.literal("LINK").describe("リンク"),
+    z.literal("DATE").describe("日付"),
+    z.literal("TIME").describe("時刻"),
+    z.literal("DATETIME").describe("日時"),
+    z.literal("FILE").describe("添付ファイル"),
+    z.literal("USER_SELECT").describe("ユーザー選択"),
+    z.literal("ORGANIZATION_SELECT").describe("組織選択"),
+    z.literal("GROUP_SELECT").describe("グループ選択"),
+    z.literal("RICH_TEXT").describe("リッチエディター"),
+    z.literal("RECORD_NUMBER").describe("レコード番号"),
+    z.literal("CREATOR").describe("作成者"),
+    z.literal("CREATED_TIME").describe("作成日時"),
+    z.literal("MODIFIER").describe("更新者"),
+    z.literal("UPDATED_TIME").describe("更新日時"),
+    z.literal("REFERENCE_TABLE").describe("関連レコード一覧"),
+]);
+// Standard field with code
+const standardFieldSchema = z.object({
+    type: fieldTypesWithCode.describe("The field type"),
+    code: z.string().describe("The field code"),
+    size: z
+        .object({
+        width: z.string().describe("Field width"),
+        height: z.string().optional().describe("Field height"),
+        innerHeight: z
+            .string()
+            .optional()
+            .describe("Inner height for multi-line text"),
+    })
+        .optional()
+        .describe("Field size configuration"),
+});
+// LABEL field with label property instead of code
+const labelFieldSchema = z.object({
+    type: z.literal("LABEL").describe("Label field type"),
+    label: z.string().describe("The label text"),
+    size: z
+        .object({
+        width: z.string().describe("Field width"),
+    })
+        .optional()
+        .describe("Field size configuration"),
+});
+// SPACER field with elementId instead of code
+const spacerFieldSchema = z.object({
+    type: z.literal("SPACER").describe("Spacer field type"),
+    elementId: z.string().describe("The element ID"),
+    size: z
+        .object({
+        width: z.string().describe("Field width"),
+        height: z.string().optional().describe("Field height"),
+    })
+        .optional()
+        .describe("Field size configuration"),
+});
+// HR field without code
+const hrFieldSchema = z.object({
+    type: z.literal("HR").describe("Horizontal rule field type"),
+    size: z
+        .object({
+        width: z.string().describe("Field width"),
+    })
+        .optional()
+        .describe("Field size configuration"),
+});
+const layoutFieldSchema = z.union([
+    standardFieldSchema,
+    labelFieldSchema,
+    spacerFieldSchema,
+    hrFieldSchema,
+]);
+const layoutRowSchema = z.object({
+    type: z.literal("ROW").describe("Row type identifier"),
+    fields: z.array(layoutFieldSchema).describe("Array of fields in this row"),
+});
+const layoutSubtableSchema = z.object({
+    type: z.literal("SUBTABLE").describe("Subtable type identifier"),
+    code: z.string().describe("Subtable field code"),
+    fields: z
+        .array(layoutFieldSchema)
+        .describe("Array of fields in this subtable"),
+});
+export const layoutElementSchema = z.lazy(() => z.union([layoutRowSchema, layoutSubtableSchema, layoutGroupSchema]));
+const layoutGroupSchema = z.object({
+    type: z.literal("GROUP").describe("Group type identifier"),
+    code: z.string().describe("Group field code"),
+    layout: z
+        .array(layoutElementSchema)
+        .describe("Nested layout elements within this group"),
+});

package/dist/schema/app/index.js

@@ -0,0 +1 @@
+export { layoutElementSchema } from "./form-layout.js";

package/dist/schema/record/index.js

@@ -0,0 +1,2 @@
+export { recordSchemaForParameter, recordSchemaForParameterWithoutFile, } from "./record-for-parameter.js";
+export { recordSchema } from "./records.js";

package/dist/schema/record/records.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export const recordValueSchema = z.union([
+const recordValueSchema = z.union([
     z.object({
         type: z.literal("SINGLE_LINE_TEXT"),
         value: z.string().nullable(),

package/dist/server/index.js

@@ -0,0 +1,17 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { shouldEnableTool } from "./tool-filters.js";
+import { getKintoneClient } from "../client/index.js";
+import { createToolCallback, tools } from "../tools/index.js";
+export const createServer = (options) => {
+    const server = new McpServer({
+        name: options.name,
+        version: options.version,
+    });
+    const client = getKintoneClient(options.config.clientConfig);
+    const toolCondition = options.config.toolConditionConfig;
+    const attachmentsDir = options.config.fileConfig.attachmentsDir;
+    tools
+        .filter((tool) => shouldEnableTool(tool.name, toolCondition))
+        .forEach((tool) => server.registerTool(tool.name, tool.config, createToolCallback(tool.callback, { client, attachmentsDir })));
+    return server;
+};

package/dist/server/tool-filters.js

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

package/dist/server/types/server.js

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

package/dist/tools/factory.js

@@ -0,0 +1,10 @@
+export const createTool = (name, config, callback) => {
+    return {
+        name,
+        config,
+        callback,
+    };
+};
+export const createToolCallback = (callback, options) => {
+    return (args) => callback(args, options);
+};

package/dist/tools/index.js

@@ -5,16 +5,25 @@ import { updateRecords } from "./kintone/record/update-records.js";
 import { getApp } from "./kintone/app/get-app.js";
 import { getApps } from "./kintone/app/get-apps.js";
 import { getFormFields } from "./kintone/app/get-form-fields.js";
+import { getFormLayout } from "./kintone/app/get-form-layout.js";
 import { getProcessManagement } from "./kintone/app/get-process-management.js";
+import { getAppDeployStatus } from "./kintone/app/get-app-deploy-status.js";
+import { getGeneralSettings } from "./kintone/app/get-general-settings.js";
 import { updateStatuses } from "./kintone/record/update-statuses.js";
+import { downloadFile } from "./kintone/file/download-file.js";
+export { createToolCallback } from "./factory.js";
 export const tools = [
     getApp,
     getApps,
     getFormFields,
+    getFormLayout,
     getProcessManagement,
+    getAppDeployStatus,
+    getGeneralSettings,
     updateStatuses,
     addRecords,
     deleteRecords,
     getRecords,
     updateRecords,
+    downloadFile,
 ];