@kintone/mcp-server 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [1.2.0](https://github.com/kintone/mcp-server/compare/1.1.0...1.2.0) (2025-10-01)
+
+
+### Features
+
+* add app management tools ([#113](https://github.com/kintone/mcp-server/issues/113)) ([453bd50](https://github.com/kintone/mcp-server/commit/453bd50fc9080ee452dfeaf2524bd0374bd70d74))
+* add update-form tools ([#115](https://github.com/kintone/mcp-server/issues/115)) ([c98b0cb](https://github.com/kintone/mcp-server/commit/c98b0cb3a7356cef2ee4314f76a3b8cde00b3ae3))
+
+## [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
@@ -38,9 +38,11 @@ kintoneの公式ローカルMCPサーバーです。
   - [プロキシ設定](#%E3%83%97%E3%83%AD%E3%82%AD%E3%82%B7%E8%A8%AD%E5%AE%9A)
 - [ツール一覧](#%E3%83%84%E3%83%BC%E3%83%AB%E4%B8%80%E8%A6%A7)
 - [ドキュメント](#%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88)
+- [使用上の注意](#%E4%BD%BF%E7%94%A8%E4%B8%8A%E3%81%AE%E6%B3%A8%E6%84%8F)
+  - [`kintone-download-file`ツールの注意点](#kintone-download-file%E3%83%84%E3%83%BC%E3%83%AB%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9)
 - [制限事項](#%E5%88%B6%E9%99%90%E4%BA%8B%E9%A0%85)
   - [レコード操作の制限](#%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E6%93%8D%E4%BD%9C%E3%81%AE%E5%88%B6%E9%99%90)
-  - [機能制限](#%E6%A9%9F%E8%83%BD%E5%88%B6%E9%99%90)
+  - [その他の制限](#%E3%81%9D%E3%81%AE%E4%BB%96%E3%81%AE%E5%88%B6%E9%99%90)
 - [サポート方針](#%E3%82%B5%E3%83%9D%E3%83%BC%E3%83%88%E6%96%B9%E9%87%9D)
 - [コントリビューション](#%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AA%E3%83%93%E3%83%A5%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3)
 - [ライセンス](#%E3%83%A9%E3%82%A4%E3%82%BB%E3%83%B3%E3%82%B9)
@@ -160,6 +162,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 +186,41 @@ 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-update-form-fields`      | アプリのフィールド設定を更新           |
+| `kintone-update-form-layout`      | アプリのフォームレイアウトを更新       |
+| `kintone-delete-form-fields`      | アプリのフィールドを削除               |
+| `kintone-get-process-management`  | プロセス管理設定を取得                 |
+| `kintone-get-app-deploy-status`   | アプリ設定の運用環境への反映状況確認   |
+| `kintone-get-general-settings`    | アプリの一般設定を取得                 |
+| `kintone-add-form-fields`         | アプリにフィールドを追加               |
+| `kintone-get-records`             | 複数のレコードを取得                   |
+| `kintone-add-records`             | 複数のレコードを追加                   |
+| `kintone-update-records`          | 複数のレコードを更新                   |
+| `kintone-delete-records`          | 複数のレコードを削除                   |
+| `kintone-update-statuses`         | 複数のレコードのステータスを更新       |
+| `kintone-add-app`                 | 動作テスト環境にアプリを作成           |
+| `kintone-deploy-app`              | アプリ設定を運用環境へ反映             |
+| `kintone-update-general-settings` | アプリの一般設定を変更                 |
+| `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 +231,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);
+};