@baitong-dev/mcp-helpers 0.0.1

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export declare const MCP_HOME_DIR: string;

package/dist/config.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_HOME_DIR = void 0;
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+exports.MCP_HOME_DIR = process.env.MCP_HOME_DIR || path_1.default.join(os_1.default.homedir(), '\.baitong');

package/dist/file.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env bun
+/**
+ * Check if a path is a directory.
+ * @param path The path to check
+ * @returns Whether the path is a directory
+ */
+export declare function isDir(path: string): Promise<boolean>;
+/**
+ * 检查一个目录是否是另一个目录的子目录
+ * @param parent - 父目录路径
+ * @param child - 要检查的子目录路径
+ * @param options - 配置选项
+ * @param options.includeSelf - 是否将自身视为子目录
+ * @returns - 同步返回 boolean，异步返回 Promise
+ */
+export declare function isSubdirectory(parent: string, child: string, { includeSelf }: {
+    includeSelf: boolean;
+}): boolean;

package/dist/file.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env bun
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDir = isDir;
+exports.isSubdirectory = isSubdirectory;
+const path_1 = __importDefault(require("path"));
+/**
+ * Check if a path is a directory.
+ * @param path The path to check
+ * @returns Whether the path is a directory
+ */
+async function isDir(path) {
+    try {
+        const stat = await Bun.file(path).stat();
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检查一个目录是否是另一个目录的子目录
+ * @param parent - 父目录路径
+ * @param child - 要检查的子目录路径
+ * @param options - 配置选项
+ * @param options.includeSelf - 是否将自身视为子目录
+ * @returns - 同步返回 boolean，异步返回 Promise
+ */
+function isSubdirectory(parent, child, { includeSelf = false }) {
+    const parentPath = path_1.default.resolve(parent);
+    const childPath = path_1.default.isAbsolute(child) ? child : path_1.default.join(parentPath, child);
+    const relative = path_1.default.relative(parentPath, childPath);
+    if (includeSelf && childPath === parentPath) {
+        return true;
+    }
+    return (relative && !relative.startsWith('..') && !path_1.default.isAbsolute(relative)) || false;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+export * from './config';
+export * from './file';
+export * from './process';
+export * from './util';
+export * from './wasm';

package/dist/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env bun
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+__exportStar(require("./file"), exports);
+__exportStar(require("./process"), exports);
+__exportStar(require("./util"), exports);
+__exportStar(require("./wasm"), exports);

package/dist/process.d.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+/**
+ * 将 Windows 文件路径转换为 Git Bash 路径格式
+ * @param path - Windows 格式的文件路径 (如 "C:\\Users")
+ * @returns Git Bash 格式的文件路径 (如 "/c/Users")
+ */
+export declare function windowsToGitBashPath(path: string): string;
+export declare function gitBashToWindowsPath(path: string): string;
+/**
+ * Find Git Bash executable on Windows
+ * @param customPath - Optional custom path from config
+ * @returns Full path to bash.exe or null if not found
+ */
+export declare function findGitBash(customPath?: string | null): string | null;
+/**
+ * Check if a bundled binary exists
+ * @param name Binary Name
+ * @returns Whether the binary exists
+ */
+export declare function isBinaryExists(name: string): boolean;
+/**
+ * Get full path to a bundled binary
+ * @param name Binary Name
+ * @returns Full path to the binary
+ */
+export declare function getBundledBinaryPath(name?: string): string;
+export declare function getBinaryEnvs(): {
+    PATH: string;
+    NODE: string;
+    npm_config_globalconfig: string;
+    npm_config_global_prefix: string;
+    npm_config_prefix: string;
+    npm_node_execpath: string;
+};

package/dist/process.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env bun
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.windowsToGitBashPath = windowsToGitBashPath;
+exports.gitBashToWindowsPath = gitBashToWindowsPath;
+exports.findGitBash = findGitBash;
+exports.isBinaryExists = isBinaryExists;
+exports.getBundledBinaryPath = getBundledBinaryPath;
+exports.getBinaryEnvs = getBinaryEnvs;
+const path_1 = __importDefault(require("path"));
+const config_1 = require("./config");
+const fs_1 = __importDefault(require("fs"));
+/**
+ * 将 Windows 文件路径转换为 Git Bash 路径格式
+ * @param path - Windows 格式的文件路径 (如 "C:\\Users")
+ * @returns Git Bash 格式的文件路径 (如 "/c/Users")
+ */
+function windowsToGitBashPath(path) {
+    // 非 Windows 平台直接返回原路径
+    if (process.platform !== 'win32')
+        return path;
+    if (!path)
+        return '';
+    // 1. 转换驱动器号 (C: -> /c)
+    let bashPath = path.replace(/^([A-Za-z]):/, (_, drive) => {
+        return '/' + drive.toLowerCase();
+    });
+    // 2. 转换反斜杠为正斜杠
+    bashPath = bashPath.replace(/\\/g, '/');
+    // 3. 移除可能的结尾斜杠
+    // bashPath = bashPath.replace(/\/$/, '')
+    return bashPath;
+}
+function gitBashToWindowsPath(path) {
+    // 非 Git Bash 平台直接返回原路径
+    if (process.platform !== 'win32')
+        return path;
+    if (!path)
+        return '';
+    // 1. 转换驱动器号 (/c -> C:)
+    let windowsPath = path.replace(/^\/([a-z])\//, (_, drive) => `${drive.toUpperCase()}:\\`);
+    // 2. 转换正斜杠为反斜杠
+    windowsPath = windowsPath.replace(/\//g, '\\');
+    return windowsPath;
+}
+/**
+ * Validate Git Bash path on Windows
+ * @param customPath - Custom path to validate
+ * @returns Validated path or null if invalid
+ */
+function validateGitBashPath(customPath) {
+    if (!customPath) {
+        return null;
+    }
+    const resolved = path_1.default.resolve(customPath);
+    if (!Bun.file(resolved).size) {
+        return null;
+    }
+    const isExe = resolved.toLowerCase().endsWith('bash.exe');
+    if (!isExe) {
+        return null;
+    }
+    return resolved;
+}
+/**
+ * Find Git Bash executable on Windows
+ * @param customPath - Optional custom path from config
+ * @returns Full path to bash.exe or null if not found
+ */
+function findGitBash(customPath) {
+    // Git Bash is Windows-only
+    if (!(process.platform === 'win32')) {
+        return null;
+    }
+    // 1. Check custom path from config first
+    if (customPath) {
+        const validated = validateGitBashPath(customPath);
+        if (validated) {
+            return validated;
+        }
+    }
+    // 2. Check environment variable override
+    const envOverride = process.env.CLAUDE_CODE_GIT_BASH_PATH;
+    if (envOverride) {
+        const validated = validateGitBashPath(envOverride);
+        if (validated) {
+            return validated;
+        }
+    }
+    // 3. Find git.exe and derive bash.exe path
+    const gitPath = Bun.which('git');
+    if (gitPath) {
+        // Try multiple possible locations for bash.exe relative to git.exe
+        // Different Git installations have different directory structures
+        const possibleBashPaths = [
+            path_1.default.join(gitPath, '..', '..', 'bin', 'bash.exe'), // Standard Git: git.exe at Git/cmd/ -> navigate up 2 levels -> then bin/bash.exe
+            path_1.default.join(gitPath, '..', 'bash.exe'), // Portable Git: git.exe at Git/bin/ -> bash.exe in same directory
+            path_1.default.join(gitPath, '..', '..', 'usr', 'bin', 'bash.exe') // MSYS2 Git: git.exe at msys64/usr/bin/ -> navigate up 2 levels -> then usr/bin/bash.exe
+        ];
+        for (const bashPath of possibleBashPaths) {
+            const resolvedBashPath = path_1.default.resolve(bashPath);
+            if (Bun.file(resolvedBashPath).size) {
+                return resolvedBashPath;
+            }
+        }
+    }
+    // 4. Fallback: check common Git Bash paths directly
+    const commonBashPaths = [
+        path_1.default.join(process.env.ProgramFiles || 'C:\\Program Files', 'Git', 'bin', 'bash.exe'),
+        path_1.default.join(process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)', 'Git', 'bin', 'bash.exe'),
+        ...(process.env.LOCALAPPDATA
+            ? [path_1.default.join(process.env.LOCALAPPDATA, 'Programs', 'Git', 'bin', 'bash.exe')]
+            : [])
+    ];
+    for (const bashPath of commonBashPaths) {
+        if (Bun.file(bashPath).size) {
+            return bashPath;
+        }
+    }
+    return null;
+}
+/**
+ * Add .exe extension to binary name on Windows
+ * @param name Binary Name
+ * @returns Binary Name with .exe extension on Windows
+ */
+function getBinaryName(name) {
+    if (process.platform == 'win32') {
+        if (['npm', 'npx'].includes(name)) {
+            return name;
+        }
+        return `${name}.exe`;
+    }
+    return name;
+}
+/**
+ * Check if a bundled binary exists
+ * @param name Binary Name
+ * @returns Whether the binary exists
+ */
+function isBinaryExists(name) {
+    const cmd = getBundledBinaryPath(name);
+    return Bun.file(cmd).size > 0;
+}
+/**
+ * Get full path to a bundled binary
+ * @param name Binary Name
+ * @returns Full path to the binary
+ */
+function getBundledBinaryPath(name) {
+    const binariesDir = path_1.default.join(config_1.MCP_HOME_DIR, 'bin');
+    if (!name) {
+        return binariesDir;
+    }
+    const binaryName = getBinaryName(name);
+    const binariesDirExists = fs_1.default.existsSync(binariesDir);
+    if (binariesDirExists) {
+        if (['git', 'bash', 'sh'].includes(name)) {
+            // Git binaries are in a subdirectory
+            return path_1.default.join(binariesDir, 'PortableGit/bin', binaryName);
+        }
+        if (['node', 'npm', 'npx'].includes(name)) {
+            // Node.js binaries are in a subdirectory
+            return path_1.default.join(binariesDir, 'node', binaryName);
+        }
+        if (['python', 'python3'].includes(name)) {
+            // Python binaries are in a subdirectory
+            return path_1.default.join(binariesDir, 'python', binaryName);
+        }
+        if (['pip', 'pip3'].includes(name)) {
+            // pip binaries are in a subdirectory
+            return path_1.default.join(binariesDir, 'python/Scripts', binaryName);
+        }
+        return path_1.default.join(binariesDir, binaryName);
+    }
+    return binaryName;
+}
+function getBinaryEnvs() {
+    const binariesDir = getBundledBinaryPath();
+    const envPaths = process.env?.path?.split(';') || [];
+    envPaths.unshift(binariesDir); // bun uv uvx
+    envPaths.unshift(path_1.default.join(binariesDir, 'node')); // node
+    envPaths.unshift(path_1.default.join(binariesDir, 'python')); // python
+    envPaths.unshift(path_1.default.join(binariesDir, 'python/Scripts')); // pip
+    const nodePath = getBundledBinaryPath('node');
+    const nodeDir = path_1.default.join(nodePath, '..');
+    return {
+        PATH: envPaths.join(';'),
+        NODE: nodePath,
+        npm_config_globalconfig: path_1.default.join(nodeDir, 'etc', 'npmrc'),
+        npm_config_global_prefix: nodeDir,
+        npm_config_prefix: nodeDir,
+        npm_node_execpath: nodePath
+    };
+}

package/dist/util.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+/**
+ * Lazily initialize a value.
+ * @param fn A function that returns the value to be lazily initialized
+ * @returns A function that, when called, either returns the cached value or initializes it
+ */
+export declare function lazy<T>(fn: () => T): {
+    (): T;
+    reset(): void;
+};

package/dist/util.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env bun
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lazy = lazy;
+/**
+ * Lazily initialize a value.
+ * @param fn A function that returns the value to be lazily initialized
+ * @returns A function that, when called, either returns the cached value or initializes it
+ */
+function lazy(fn) {
+    let value;
+    let loaded = false;
+    const result = () => {
+        if (loaded)
+            return value;
+        try {
+            value = fn();
+            loaded = true;
+            return value;
+        }
+        catch (e) {
+            // Don't mark as loaded if initialization failed
+            throw e;
+        }
+    };
+    result.reset = () => {
+        loaded = false;
+        value = undefined;
+    };
+    return result;
+}

package/dist/wasm.d.ts

@@ -0,0 +1 @@
+export declare const resolveWasm: (asset: string) => string;

package/dist/wasm.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWasm = void 0;
+const url_1 = require("url");
+const resolveWasm = (asset) => {
+    if (asset.startsWith('file://'))
+        return (0, url_1.fileURLToPath)(asset);
+    if (asset.startsWith('/') || /^[a-z]:/i.test(asset))
+        return asset;
+    const url = new URL(asset, process.cwd());
+    return (0, url_1.fileURLToPath)(url);
+};
+exports.resolveWasm = resolveWasm;

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@baitong-dev/mcp-helpers",
+  "version": "0.0.1",
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "helpers"
+  ],
+  "description": "mcp-helpers",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "tsc": "tsc ./src/index.ts  --declaration --module commonjs  --target es2021 --esModuleInterop --outDir ./dist"
+  }
+}