@baitong-dev/bash-mcp 0.0.2 → 0.0.4

package/descriptions/glob.txt

@@ -0,0 +1,6 @@
+- Fast file pattern matching tool that works with any codebase size
+- Supports glob patterns like "**/*.js" or "src/**/*.ts"
+- Returns matching file paths sorted by modification time
+- Use this tool when you need to find files by name patterns
+- When you are doing an open-ended search that may require multiple rounds of globbing and grepping, use the Task tool instead
+- You have the capability to call multiple tools in a single response. It is always better to speculatively perform multiple searches as a batch that are potentially useful.

package/descriptions/grep.txt

@@ -0,0 +1,8 @@
+- Fast content search tool that works with any codebase size
+- Searches file contents using regular expressions
+- Supports full regex syntax (eg. "log.*Error", "function\s+\w+", etc.)
+- Filter files by pattern with the include parameter (eg. "*.js", "*.{ts,tsx}")
+- Returns file paths and line numbers with at least one match sorted by modification time
+- Use this tool when you need to find files containing specific patterns
+- If you need to identify/count the number of matches within files, use the Bash tool with `rg` (ripgrep) directly. Do NOT use `grep`.
+- When you are doing an open-ended search that may require multiple rounds of globbing and grepping, use the Task tool instead

package/descriptions/ls.txt

@@ -0,0 +1 @@
+Lists files and directories in a given path. The path parameter must be absolute; omit it to use the current workspace directory. You can optionally provide an array of glob patterns to ignore with the ignore parameter. You should generally prefer the Glob and Grep tools, if you know which directories to search.

package/dist/bash.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Environment variables to inherit by default, if an environment is not explicitly given.
+ */
+export declare const DEFAULT_INHERITED_ENV_VARS: string[];
+/**
+ * Returns a default environment object including only environment variables deemed safe to inherit.
+ */
+export declare function getDefaultEnvs(): {};
+export declare function registerBashTool(server: McpServer): void;

package/dist/bash.js

@@ -0,0 +1,333 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_INHERITED_ENV_VARS = void 0;
+exports.getDefaultEnvs = getDefaultEnvs;
+exports.registerBashTool = registerBashTool;
+const path_1 = __importDefault(require("path"));
+const zod_1 = __importDefault(require("zod"));
+const web_tree_sitter_1 = require("web-tree-sitter");
+// @ts-ignore wasm
+const web_tree_sitter_wasm_1 = __importDefault(require("web-tree-sitter/web-tree-sitter.wasm"));
+// @ts-ignore wasm
+const tree_sitter_bash_wasm_1 = __importDefault(require("tree-sitter-bash/tree-sitter-bash.wasm"));
+const child_process_1 = require("child_process");
+const bash_txt_1 = __importDefault(require("../descriptions/bash.txt"));
+const mcp_helpers_1 = require("@baitong-dev/mcp-helpers");
+const parser = (0, mcp_helpers_1.lazy)(async () => {
+    const treePath = (0, mcp_helpers_1.resolveWasm)(web_tree_sitter_wasm_1.default);
+    await web_tree_sitter_1.Parser.init({
+        locateFile() {
+            return treePath;
+        }
+    });
+    const bashPath = (0, mcp_helpers_1.resolveWasm)(tree_sitter_bash_wasm_1.default);
+    const bashLanguage = await web_tree_sitter_1.Language.load(bashPath);
+    const p = new web_tree_sitter_1.Parser();
+    p.setLanguage(bashLanguage);
+    return p;
+});
+/**
+ * Get the path to the bash executable
+ * @returns The path to the bash executable
+ */
+const getBashPath = (0, mcp_helpers_1.lazy)(() => {
+    const shell = process.env.SHELL;
+    if (shell)
+        return shell;
+    // Fallback: check common Git Bash paths directly
+    if (process.platform === 'win32') {
+        const bash = (0, mcp_helpers_1.findGitBash)((0, mcp_helpers_1.getBundledBinaryPath)('bash'));
+        if (bash)
+            return bash;
+        throw new Error('Git Bash not found');
+        // return process.env.COMSPEC || "cmd.exe"
+    }
+    if (process.platform === 'darwin')
+        return '/bin/zsh';
+    const bash = Bun.which('bash');
+    if (bash)
+        return bash;
+    return '/bin/sh';
+});
+// =============================================================================
+// Constants
+// =============================================================================
+// Default working directory
+const DEFAULT_CWD = path_1.default.join(mcp_helpers_1.MCP_HOME_DIR, 'workspace');
+// Grace period before SIGKILL (ms)
+const SIGKILL_TIMEOUT_MS = 5000;
+// Reserved characters for truncation ellipsis
+const TRUNCATION_ELLIPSIS_RESERVE = 50;
+// Exit code for timeout (shell convention)
+const EXIT_CODE_TIMEOUT = 124;
+// Sudo rejection message
+const SUDO_REJECTION_MESSAGE = '[REJECTED] sudo commands cannot be executed. Please STOP and ask human user to run it for you!\n';
+// Default max_output
+const DEFAULT_MAX_OUTPUT = 30000;
+const DEFAULT_TIMEOUT_MS = 2 * 60 * 1000;
+/**
+ * Check if a command contains sudo
+ * Matches: sudo at start, after semicolon, after &&, after ||, after |, after $(, after backtick
+ */
+function containsSudo(command) {
+    // Match sudo as a standalone command (not part of another word like "pseudocode")
+    return /(?:^|[;&|`$()]\s*)sudo(?:\s|$)/m.test(command);
+}
+/**
+ * Environment variables to inherit by default, if an environment is not explicitly given.
+ */
+exports.DEFAULT_INHERITED_ENV_VARS = process.platform === 'win32'
+    ? [
+        'APPDATA',
+        'HOMEDRIVE',
+        'HOMEPATH',
+        'LOCALAPPDATA',
+        'PATH',
+        'PROCESSOR_ARCHITECTURE',
+        'SYSTEMDRIVE',
+        'SYSTEMROOT',
+        'TEMP',
+        'TMPDIR',
+        'USERNAME',
+        'USERPROFILE',
+        'PROGRAMFILES'
+    ]
+    : /* list inspired by the default env inheritance of sudo */
+        ['HOME', 'LOGNAME', 'PATH', 'SHELL', 'TERM', 'USER'];
+/**
+ * Returns a default environment object including only environment variables deemed safe to inherit.
+ */
+function getDefaultEnvs() {
+    const env = {};
+    for (const key of exports.DEFAULT_INHERITED_ENV_VARS) {
+        const value = process.env[key];
+        if (value === undefined) {
+            continue;
+        }
+        if (value.startsWith('()')) {
+            // Skip functions, which are a security risk.
+            continue;
+        }
+        env[key] = value;
+    }
+    return env;
+}
+/**
+ * Middle-truncate output to preserve beginning and end
+ */
+function middleTruncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    const halfLength = Math.floor((maxLength - TRUNCATION_ELLIPSIS_RESERVE) / 2);
+    const start = text.slice(0, halfLength);
+    const end = text.slice(-halfLength);
+    const truncatedBytes = text.length - maxLength;
+    return `${start}\n\n... [truncated ${truncatedBytes} characters] ...\n\n${end}`;
+}
+const inputSchema = zod_1.default.object({
+    command: zod_1.default.string().min(1).describe('The command to execute'),
+    cwd: zod_1.default
+        .string()
+        .optional()
+        .describe(`The working directory to run the command in. Must be in ${DEFAULT_CWD}. Defaults to ${DEFAULT_CWD}. Use this instead of 'cd' commands.`), // 需要在DEFAULT_CWD下
+    timeout: zod_1.default
+        .number()
+        .min(1)
+        .max(600000)
+        .optional()
+        .describe(`Timeout in milliseconds (optional, default ${DEFAULT_TIMEOUT_MS}, max 600000)`),
+    description: zod_1.default
+        .string()
+        .describe('Clear, concise description of what this command does in 5-10 words. Examples:\nInput: ls\nOutput: Lists files in current directory\n\nInput: git status\nOutput: Shows working tree status\n\nInput: npm install\nOutput: Installs package dependencies\n\nInput: mkdir foo\nOutput: Creates directory "foo"'),
+    env: zod_1.default
+        .record(zod_1.default.string(), zod_1.default.string())
+        .optional()
+        .describe('Additional environment variables to set'),
+    maxOutput: zod_1.default
+        .number()
+        .min(1)
+        .max(1000000)
+        .optional()
+        .describe(`Maximum output length before middle-truncation (default ${DEFAULT_MAX_OUTPUT})`)
+});
+async function killTree(proc, opts) {
+    const pid = proc.pid;
+    if (!pid || opts?.exited?.())
+        return;
+    if (process.platform === 'win32') {
+        await new Promise(resolve => {
+            const killer = (0, child_process_1.spawn)('taskkill', ['/pid', String(pid), '/f', '/t'], { stdio: 'ignore' });
+            killer.once('exit', () => resolve());
+            killer.once('error', () => resolve());
+        });
+        return;
+    }
+    try {
+        process.kill(-pid, 'SIGTERM');
+        await Bun.sleep(SIGKILL_TIMEOUT_MS);
+        if (!opts?.exited?.()) {
+            process.kill(-pid, 'SIGKILL');
+        }
+    }
+    catch (_e) {
+        proc.kill('SIGTERM');
+        await Bun.sleep(SIGKILL_TIMEOUT_MS);
+        if (!opts?.exited?.()) {
+            proc.kill('SIGKILL');
+        }
+    }
+}
+/**
+ * Execute a bash command and return result
+ */
+async function executeBash(options) {
+    const command = options.command.trim();
+    const cwd = options.cwd || DEFAULT_CWD;
+    const timeout = options.timeout || DEFAULT_TIMEOUT_MS;
+    const maxOutput = options.maxOutput || DEFAULT_MAX_OUTPUT;
+    if (containsSudo(command)) {
+        throw Error(`${SUDO_REJECTION_MESSAGE}$ ${command}`);
+    }
+    if (!(0, mcp_helpers_1.isSubdirectory)(DEFAULT_CWD, cwd, {
+        includeSelf: true
+    })) {
+        throw Error(`"${cwd}" must be in ${DEFAULT_CWD}`);
+    }
+    if (!(await (0, mcp_helpers_1.isDir)(cwd))) {
+        throw Error(`"${cwd}" must be a directory`);
+    }
+    const tree = await parser().then(p => p.parse(command));
+    if (!tree) {
+        throw new Error('Failed to parse command');
+    }
+    const directories = new Set();
+    // if (!Instance.containsPath(cwd)) directories.add(cwd)
+    const patterns = new Set();
+    // const always = new Set<string>()
+    let output = '';
+    for (const node of tree.rootNode.descendantsOfType('command')) {
+        if (!node)
+            continue;
+        // Get full command text including redirects if present
+        const commandText = node.parent?.type === 'redirected_statement' ? node.parent.text : node.text;
+        const commands = [];
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (!child)
+                continue;
+            if (child.type !== 'command_name' &&
+                child.type !== 'word' &&
+                child.type !== 'string' &&
+                child.type !== 'raw_string' &&
+                child.type !== 'concatenation') {
+                continue;
+            }
+            commands.push(child.text);
+        }
+        // not an exhaustive list, but covers most common cases
+        if (['cd', 'rm', 'cp', 'mv', 'mkdir', 'touch', 'chmod', 'chown', 'cat'].includes(commands[0])) {
+            for (const arg of commands.slice(1)) {
+                if (arg.startsWith('-') || (commands[0] === 'chmod' && arg.startsWith('+'))) {
+                    continue;
+                }
+                const resolved = await Bun.$ `realpath ${arg}`
+                    .cwd(cwd)
+                    .quiet()
+                    .nothrow()
+                    .text()
+                    .then(x => x.trim());
+                if (resolved) {
+                    // Git Bash on Windows returns Unix-style paths like /c/Users/...
+                    const normalized = process.platform === 'win32' && resolved.match(/^\/[a-z]\//)
+                        ? (0, mcp_helpers_1.gitBashToWindowsPath)(resolved)
+                        : resolved;
+                    if (!(0, mcp_helpers_1.isSubdirectory)(DEFAULT_CWD, normalized, { includeSelf: true })) {
+                        const dir = (await (0, mcp_helpers_1.isDir)(normalized)) ? normalized : path_1.default.dirname(normalized);
+                        directories.add(dir);
+                    }
+                }
+            }
+        }
+        else {
+            //
+        }
+        // cd covered by above check
+        if (commands.length && commands[0] !== 'cd') {
+            patterns.add(commandText);
+            // always.add(BashArity.prefix(command).join(' ') + ' *')
+        }
+    }
+    const mergedEnv = {
+        ...getDefaultEnvs(),
+        ...(0, mcp_helpers_1.getBundledBinaryEnvs)()
+    };
+    const proc = (0, child_process_1.spawn)(command, {
+        shell: getBashPath(),
+        cwd,
+        env: {
+            ...mergedEnv
+        },
+        stdio: ['ignore', 'pipe', 'pipe'],
+        detached: process.platform !== 'win32'
+    });
+    const append = (chunk) => {
+        output += chunk.toString();
+    };
+    proc.stdout?.on('data', append);
+    proc.stderr?.on('data', append);
+    let timedOut = false;
+    let exited = false;
+    const kill = () => killTree(proc, { exited: () => exited });
+    const timeoutTimer = setTimeout(() => {
+        timedOut = true;
+        void kill();
+    }, timeout + 100);
+    await new Promise((resolve, reject) => {
+        const cleanup = () => {
+            clearTimeout(timeoutTimer);
+        };
+        proc.once('exit', () => {
+            exited = true;
+            cleanup();
+            resolve();
+        });
+        proc.once('error', error => {
+            exited = true;
+            cleanup();
+            reject(error);
+        });
+    });
+    const resultMetadata = [];
+    if (timedOut) {
+        resultMetadata.push(`bash tool terminated command after exceeding timeout ${timeout} ms`);
+    }
+    if (resultMetadata.length > 0) {
+        output += '\n\n<bash_metadata>\n' + resultMetadata.join('\n') + '\n</bash_metadata>';
+    }
+    return {
+        title: options.description,
+        metadata: {
+            output: middleTruncate(output, maxOutput),
+            exit: proc.exitCode,
+            description: options.description
+        },
+        output
+    };
+}
+function registerBashTool(server) {
+    server.registerTool('bash', {
+        description: bash_txt_1.default.replaceAll('${directory}', DEFAULT_CWD)
+            .replaceAll('${maxLines}', String(2000))
+            .replaceAll('${maxBytes}', String(50 * 1024)),
+        inputSchema
+    }, async (args) => {
+        const result = await executeBash({ ...args });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+            structuredContent: result
+        };
+    });
+}

package/dist/glob.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGlobTool(server: McpServer): void;

package/dist/glob.js

@@ -0,0 +1,109 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGlobTool = registerGlobTool;
+const glob_txt_1 = __importDefault(require("../descriptions/glob.txt"));
+const zod_1 = __importDefault(require("zod"));
+const path_1 = __importDefault(require("path"));
+const mcp_helpers_1 = require("@baitong-dev/mcp-helpers");
+const fs = __importStar(require("fs"));
+const FILE_LIMIT = 100;
+function registerGlobTool(server) {
+    server.registerTool('glob', {
+        description: glob_txt_1.default,
+        inputSchema: zod_1.default.object({
+            pattern: zod_1.default.string().describe('The glob pattern to match files against'),
+            path: zod_1.default
+                .string()
+                .optional()
+                .describe(`The directory to search in. If not specified, the current working directory will be used. IMPORTANT: Omit this field to use the default directory. DO NOT enter "undefined" or "null" - simply omit it for the default behavior. Must be a valid directory path if provided.`)
+        })
+    }, async (args) => {
+        if (!args.pattern) {
+            throw new Error('pattern is required');
+        }
+        let searchPath = args.path ?? mcp_helpers_1.MCP_WORKSPACE_DIR;
+        searchPath = path_1.default.isAbsolute(searchPath)
+            ? searchPath
+            : path_1.default.resolve(mcp_helpers_1.MCP_WORKSPACE_DIR, searchPath);
+        // await assertExternalDirectory(ctx, searchPath, { kind: 'directory' })
+        const limit = FILE_LIMIT;
+        const files = [];
+        let truncated = false;
+        const rgFiles = await mcp_helpers_1.Ripgrep.files({
+            cwd: searchPath,
+            glob: [args.pattern]
+            // signal: ctx.abort
+        });
+        for (const file of rgFiles) {
+            if (files.length >= limit) {
+                truncated = true;
+                break;
+            }
+            const full = path_1.default.resolve(searchPath, file);
+            const stats = fs.statSync(full, { throwIfNoEntry: false })?.mtime.getTime() ?? 0;
+            files.push({
+                path: full,
+                mtime: stats
+            });
+        }
+        files.sort((a, b) => b.mtime - a.mtime);
+        const output = [];
+        if (files.length === 0)
+            output.push('No files found');
+        if (files.length > 0) {
+            output.push(...files.map(f => f.path));
+            if (truncated) {
+                output.push('');
+                output.push(`(Results are truncated: showing first ${limit} results. Consider using a more specific path or pattern.)`);
+            }
+        }
+        const result = {
+            title: path_1.default.relative(mcp_helpers_1.MCP_WORKSPACE_DIR, searchPath),
+            metadata: {
+                count: files.length,
+                truncated
+            },
+            output: output.join('\n')
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+            structuredContent: result
+        };
+    });
+}

package/dist/grep.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface GrepToolResult {
+    title: string;
+    metadata: {
+        matches: number;
+        truncated: boolean;
+    };
+    output: string;
+}
+export declare function registerGrepTool(server: McpServer): void;

package/dist/grep.js

@@ -0,0 +1,182 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGrepTool = registerGrepTool;
+const grep_txt_1 = __importDefault(require("../descriptions/grep.txt"));
+const zod_1 = __importDefault(require("zod"));
+const path_1 = __importDefault(require("path"));
+const mcp_helpers_1 = require("@baitong-dev/mcp-helpers");
+const consumers_1 = require("stream/consumers");
+const fs = __importStar(require("fs"));
+const FILE_LIMIT = 100;
+const MAX_LINE_LENGTH = 2000;
+function handleResult(result) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+        structuredContent: result
+    };
+}
+function registerGrepTool(server) {
+    server.registerTool('grep', {
+        description: grep_txt_1.default,
+        inputSchema: zod_1.default.object({
+            pattern: zod_1.default.string().describe('The regex pattern to search for in file contents'),
+            path: zod_1.default
+                .string()
+                .optional()
+                .describe('The directory to search in. Defaults to the current working directory.'),
+            include: zod_1.default
+                .string()
+                .optional()
+                .describe('File pattern to include in the search (e.g. "*.js", "*.{ts,tsx}")')
+        })
+    }, async (args) => {
+        if (!args.pattern) {
+            throw new Error('pattern is required');
+        }
+        let searchPath = args.path ?? mcp_helpers_1.MCP_WORKSPACE_DIR;
+        searchPath = path_1.default.isAbsolute(searchPath)
+            ? searchPath
+            : path_1.default.resolve(mcp_helpers_1.MCP_WORKSPACE_DIR, searchPath);
+        // await assertExternalDirectory(ctx, searchPath, { kind: 'directory' })
+        const rgPath = await mcp_helpers_1.Ripgrep.filepath();
+        const rgArgs = [
+            '-nH',
+            '--hidden',
+            '--no-messages',
+            '--field-match-separator=|',
+            '--regexp',
+            args.pattern
+        ];
+        if (args.include) {
+            rgArgs.push('--glob', args.include);
+        }
+        rgArgs.push(searchPath);
+        const proc = mcp_helpers_1.SimpleProcess.spawn(rgPath, rgArgs, {
+            stdout: 'pipe',
+            stderr: 'pipe'
+            // abort: ctx.abort
+        });
+        if (!proc.stdout || !proc.stderr) {
+            throw new Error('Process output not available');
+        }
+        const output = await (0, consumers_1.text)(proc.stdout);
+        const errorOutput = await (0, consumers_1.text)(proc.stderr);
+        const exitCode = await proc.exited;
+        // Exit codes: 0 = matches found, 1 = no matches, 2 = errors (but may still have matches)
+        // With --no-messages, we suppress error output but still get exit code 2 for broken symlinks etc.
+        // Only fail if exit code is 2 AND no output was produced
+        if (exitCode === 1 || (exitCode === 2 && !output.trim())) {
+            return handleResult({
+                title: args.pattern,
+                metadata: { matches: 0, truncated: false },
+                output: 'No files found'
+            });
+        }
+        if (exitCode !== 0 && exitCode !== 2) {
+            throw new Error(`ripgrep failed: ${errorOutput}`);
+        }
+        const hasErrors = exitCode === 2;
+        // Handle both Unix (\n) and Windows (\r\n) line endings
+        const lines = output.trim().split(/\r?\n/);
+        const matches = [];
+        for (const line of lines) {
+            if (!line)
+                continue;
+            const [filePath, lineNumStr, ...lineTextParts] = line.split('|');
+            if (!filePath || !lineNumStr || lineTextParts.length === 0)
+                continue;
+            const lineNum = parseInt(lineNumStr, 10);
+            const lineText = lineTextParts.join('|');
+            const stats = fs.statSync(filePath, { throwIfNoEntry: false });
+            if (!stats)
+                continue;
+            matches.push({
+                path: filePath,
+                modTime: stats.mtime.getTime(),
+                lineNum,
+                lineText
+            });
+        }
+        matches.sort((a, b) => b.modTime - a.modTime);
+        const limit = FILE_LIMIT;
+        const truncated = matches.length > limit;
+        const finalMatches = truncated ? matches.slice(0, limit) : matches;
+        if (finalMatches.length === 0) {
+            return handleResult({
+                title: args.pattern,
+                metadata: { matches: 0, truncated: false },
+                output: 'No files found'
+            });
+        }
+        const totalMatches = matches.length;
+        const outputLines = [
+            `Found ${totalMatches} matches${truncated ? ` (showing first ${limit})` : ''}`
+        ];
+        let currentFile = '';
+        for (const match of finalMatches) {
+            if (currentFile !== match.path) {
+                if (currentFile !== '') {
+                    outputLines.push('');
+                }
+                currentFile = match.path;
+                outputLines.push(`${match.path}:`);
+            }
+            const truncatedLineText = match.lineText.length > MAX_LINE_LENGTH
+                ? match.lineText.substring(0, MAX_LINE_LENGTH) + '...'
+                : match.lineText;
+            outputLines.push(`  Line ${match.lineNum}: ${truncatedLineText}`);
+        }
+        if (truncated) {
+            outputLines.push('');
+            outputLines.push(`(Results truncated: showing ${limit} of ${totalMatches} matches (${totalMatches - limit} hidden). Consider using a more specific path or pattern.)`);
+        }
+        if (hasErrors) {
+            outputLines.push('');
+            outputLines.push('(Some paths were inaccessible and skipped)');
+        }
+        return handleResult({
+            title: args.pattern,
+            metadata: {
+                matches: totalMatches,
+                truncated
+            },
+            output
+        });
+    });
+}

package/dist/index.js

@@ -1,62 +1,14 @@
 #!/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 });
-/**
- * Bash MCP Server v1.0
- */
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const path_1 = __importDefault(require("path"));
-const zod_1 = __importDefault(require("zod"));
-const web_tree_sitter_1 = require("web-tree-sitter");
-// @ts-ignore wasm
-const web_tree_sitter_wasm_1 = __importDefault(require("web-tree-sitter/web-tree-sitter.wasm"));
-// @ts-ignore wasm
-const tree_sitter_bash_wasm_1 = __importDefault(require("tree-sitter-bash/tree-sitter-bash.wasm"));
-const child_process_1 = require("child_process");
-const bash_txt_1 = __importDefault(require("../bash.txt"));
-const mcp_helpers_1 = require("@baitong-dev/mcp-helpers");
+const ls_1 = require("./ls");
+const bash_1 = require("./bash");
+const grep_1 = require("./grep");
+const glob_1 = require("./glob");
 const MCP_NAME = 'Bash MCP';
-const MCP_VERSION = '0.0.1';
-const parser = (0, mcp_helpers_1.lazy)(async () => {
-    const treePath = (0, mcp_helpers_1.resolveWasm)(web_tree_sitter_wasm_1.default);
-    await web_tree_sitter_1.Parser.init({
-        locateFile() {
-            return treePath;
-        }
-    });
-    const bashPath = (0, mcp_helpers_1.resolveWasm)(tree_sitter_bash_wasm_1.default);
-    const bashLanguage = await web_tree_sitter_1.Language.load(bashPath);
-    const p = new web_tree_sitter_1.Parser();
-    p.setLanguage(bashLanguage);
-    return p;
-});
-/**
- * Get the path to the bash executable
- * @returns The path to the bash executable
- */
-const getBashPath = (0, mcp_helpers_1.lazy)(() => {
-    const shell = process.env.SHELL;
-    if (shell)
-        return shell;
-    // Fallback: check common Git Bash paths directly
-    if (process.platform === 'win32') {
-        const bash = (0, mcp_helpers_1.findGitBash)((0, mcp_helpers_1.getBundledBinaryPath)('bash'));
-        if (bash)
-            return bash;
-        throw new Error('Git Bash not found');
-        // return process.env.COMSPEC || "cmd.exe"
-    }
-    if (process.platform === 'darwin')
-        return '/bin/zsh';
-    const bash = Bun.which('bash');
-    if (bash)
-        return bash;
-    return '/bin/sh';
-});
+const MCP_VERSION = '0.0.4';
 const server = new mcp_js_1.McpServer({
     name: MCP_NAME,
     version: MCP_VERSION
@@ -65,285 +17,10 @@ const server = new mcp_js_1.McpServer({
         logging: {}
     }
 });
-// =============================================================================
-// Constants
-// =============================================================================
-// Default working directory
-const DEFAULT_CWD = path_1.default.join(mcp_helpers_1.MCP_HOME_DIR, 'workspace');
-// Grace period before SIGKILL (ms)
-const SIGKILL_TIMEOUT_MS = 5000;
-// Reserved characters for truncation ellipsis
-const TRUNCATION_ELLIPSIS_RESERVE = 50;
-// Exit code for timeout (shell convention)
-const EXIT_CODE_TIMEOUT = 124;
-// Sudo rejection message
-const SUDO_REJECTION_MESSAGE = '[REJECTED] sudo commands cannot be executed. Please STOP and ask human user to run it for you!\n';
-// Default max_output
-const DEFAULT_MAX_OUTPUT = 30000;
-const DEFAULT_TIMEOUT_MS = 2 * 60 * 1000;
-// Environment variables that cannot be overridden (hardened mode only)
-const PROTECTED_ENV_VARS = new Set([
-    'LD_PRELOAD',
-    'LD_LIBRARY_PATH',
-    'DYLD_INSERT_LIBRARIES',
-    'DYLD_LIBRARY_PATH'
-]);
-/**
- * Check if a command contains sudo
- * Matches: sudo at start, after semicolon, after &&, after ||, after |, after $(, after backtick
- */
-function containsSudo(command) {
-    // Match sudo as a standalone command (not part of another word like "pseudocode")
-    return /(?:^|[;&|`$()]\s*)sudo(?:\s|$)/m.test(command);
-}
-/**
- * Filter out protected environment variables that could be used for injection.
- * Only active in hardened mode. Passes everything through when hardened mode is off.
- */
-function filterEnvVars(env) {
-    if (!env)
-        return { filtered: undefined, rejected: [] };
-    const rejected = [];
-    const filtered = {};
-    for (const [key, value] of Object.entries(env)) {
-        if (PROTECTED_ENV_VARS.has(key.toUpperCase())) {
-            rejected.push(key);
-        }
-        else {
-            filtered[key] = value;
-        }
-    }
-    return { filtered: Object.keys(filtered).length > 0 ? filtered : undefined, rejected };
-}
-/**
- * Middle-truncate output to preserve beginning and end
- */
-function middleTruncate(text, maxLength) {
-    if (text.length <= maxLength)
-        return text;
-    const halfLength = Math.floor((maxLength - TRUNCATION_ELLIPSIS_RESERVE) / 2);
-    const start = text.slice(0, halfLength);
-    const end = text.slice(-halfLength);
-    const truncatedBytes = text.length - maxLength;
-    return `${start}\n\n... [truncated ${truncatedBytes} characters] ...\n\n${end}`;
-}
-// =============================================================================
-// Tool Definitions
-// =============================================================================
-const bashInputSchema = zod_1.default.object({
-    command: zod_1.default.string().min(1).describe('The command to execute'),
-    cwd: zod_1.default
-        .string()
-        .optional()
-        .describe(`The working directory to run the command in. Must be in ${DEFAULT_CWD}. Defaults to ${DEFAULT_CWD}. Use this instead of 'cd' commands.`), // 需要在DEFAULT_CWD下
-    timeout: zod_1.default
-        .number()
-        .min(1)
-        .max(600000)
-        .optional()
-        .describe(`Timeout in milliseconds (optional, default ${DEFAULT_TIMEOUT_MS}, max 600000)`),
-    description: zod_1.default
-        .string()
-        .optional()
-        .describe('Clear, concise description of what this command does in 5-10 words. Examples:\nInput: ls\nOutput: Lists files in current directory\n\nInput: git status\nOutput: Shows working tree status\n\nInput: npm install\nOutput: Installs package dependencies\n\nInput: mkdir foo\nOutput: Creates directory "foo"'),
-    env: zod_1.default
-        .record(zod_1.default.string(), zod_1.default.string())
-        .optional()
-        .describe('Additional environment variables to set'),
-    maxOutput: zod_1.default
-        .number()
-        .min(1)
-        .max(1000000)
-        .optional()
-        .describe(`Maximum output length before middle-truncation (default ${DEFAULT_MAX_OUTPUT})`)
-});
-async function killTree(proc, opts) {
-    const pid = proc.pid;
-    if (!pid || opts?.exited?.())
-        return;
-    if (process.platform === 'win32') {
-        await new Promise(resolve => {
-            const killer = (0, child_process_1.spawn)('taskkill', ['/pid', String(pid), '/f', '/t'], { stdio: 'ignore' });
-            killer.once('exit', () => resolve());
-            killer.once('error', () => resolve());
-        });
-        return;
-    }
-    try {
-        process.kill(-pid, 'SIGTERM');
-        await Bun.sleep(SIGKILL_TIMEOUT_MS);
-        if (!opts?.exited?.()) {
-            process.kill(-pid, 'SIGKILL');
-        }
-    }
-    catch (_e) {
-        proc.kill('SIGTERM');
-        await Bun.sleep(SIGKILL_TIMEOUT_MS);
-        if (!opts?.exited?.()) {
-            proc.kill('SIGKILL');
-        }
-    }
-}
-/**
- * Execute a bash command and return result
- */
-async function executeBash(options) {
-    const command = options.command.trim();
-    const cwd = options.cwd || DEFAULT_CWD;
-    const timeout = options.timeout || DEFAULT_TIMEOUT_MS;
-    const maxOutput = options.maxOutput || DEFAULT_MAX_OUTPUT;
-    const { filtered: safeEnv, rejected: rejectedVars } = filterEnvVars(options.env);
-    if (containsSudo(command)) {
-        throw Error(`${SUDO_REJECTION_MESSAGE}$ ${command}`);
-    }
-    if (!(0, mcp_helpers_1.isSubdirectory)(DEFAULT_CWD, cwd, {
-        includeSelf: true
-    })) {
-        throw Error(`"${cwd}" must be in ${DEFAULT_CWD}`);
-    }
-    if (!(await (0, mcp_helpers_1.isDir)(cwd))) {
-        throw Error(`"${cwd}" must be a directory`);
-    }
-    const tree = await parser().then(p => p.parse(command));
-    if (!tree) {
-        throw new Error('Failed to parse command');
-    }
-    const directories = new Set();
-    // if (!Instance.containsPath(cwd)) directories.add(cwd)
-    const patterns = new Set();
-    // const always = new Set<string>()
-    let output = '';
-    for (const node of tree.rootNode.descendantsOfType('command')) {
-        if (!node)
-            continue;
-        // Get full command text including redirects if present
-        let commandText = node.parent?.type === 'redirected_statement' ? node.parent.text : node.text;
-        const commands = [];
-        for (let i = 0; i < node.childCount; i++) {
-            const child = node.child(i);
-            if (!child)
-                continue;
-            if (child.type !== 'command_name' &&
-                child.type !== 'word' &&
-                child.type !== 'string' &&
-                child.type !== 'raw_string' &&
-                child.type !== 'concatenation') {
-                continue;
-            }
-            commands.push(child.text);
-        }
-        // not an exhaustive list, but covers most common cases
-        if (['cd', 'rm', 'cp', 'mv', 'mkdir', 'touch', 'chmod', 'chown', 'cat'].includes(commands[0])) {
-            for (const arg of commands.slice(1)) {
-                if (arg.startsWith('-') || (commands[0] === 'chmod' && arg.startsWith('+'))) {
-                    continue;
-                }
-                const resolved = await Bun.$ `realpath ${arg}`
-                    .cwd(cwd)
-                    .quiet()
-                    .nothrow()
-                    .text()
-                    .then(x => x.trim());
-                if (resolved) {
-                    // Git Bash on Windows returns Unix-style paths like /c/Users/...
-                    const normalized = process.platform === 'win32' && resolved.match(/^\/[a-z]\//)
-                        ? (0, mcp_helpers_1.gitBashToWindowsPath)(resolved)
-                        : resolved;
-                    if (!(0, mcp_helpers_1.isSubdirectory)(DEFAULT_CWD, normalized, { includeSelf: true })) {
-                        const dir = (await (0, mcp_helpers_1.isDir)(normalized)) ? normalized : path_1.default.dirname(normalized);
-                        directories.add(dir);
-                    }
-                }
-            }
-        }
-        else {
-        }
-        // cd covered by above check
-        if (commands.length && commands[0] !== 'cd') {
-            patterns.add(commandText);
-            // always.add(BashArity.prefix(command).join(' ') + ' *')
-        }
-    }
-    const mergedEnv = {
-        ...process.env,
-        ...safeEnv,
-        ...(0, mcp_helpers_1.getBinaryEnvs)()
-    };
-    const proc = (0, child_process_1.spawn)(command, {
-        shell: getBashPath(),
-        cwd,
-        env: {
-            ...mergedEnv
-        },
-        stdio: ['ignore', 'pipe', 'pipe'],
-        detached: process.platform !== 'win32'
-    });
-    const append = (chunk) => {
-        output += chunk.toString();
-    };
-    proc.stdout?.on('data', append);
-    proc.stderr?.on('data', append);
-    let timedOut = false;
-    let exited = false;
-    const kill = () => killTree(proc, { exited: () => exited });
-    const timeoutTimer = setTimeout(() => {
-        timedOut = true;
-        void kill();
-    }, timeout + 100);
-    await new Promise((resolve, reject) => {
-        const cleanup = () => {
-            clearTimeout(timeoutTimer);
-        };
-        proc.once('exit', () => {
-            exited = true;
-            cleanup();
-            resolve();
-        });
-        proc.once('error', error => {
-            exited = true;
-            cleanup();
-            reject(error);
-        });
-    });
-    const resultMetadata = [];
-    if (timedOut) {
-        resultMetadata.push(`bash tool terminated command after exceeding timeout ${timeout} ms`);
-    }
-    if (rejectedVars.length > 0) {
-        resultMetadata.push(`bash tool blocked env vars: ${rejectedVars.join(', ')}`);
-    }
-    if (resultMetadata.length > 0) {
-        output += '\n\n<bash_metadata>\n' + resultMetadata.join('\n') + '\n</bash_metadata>';
-    }
-    return {
-        output: middleTruncate(output, maxOutput),
-        exitCode: proc.exitCode,
-        description: options.description
-    };
-}
-server.registerTool('bash', {
-    description: bash_txt_1.default.replaceAll('${directory}', DEFAULT_CWD)
-        .replaceAll('${maxLines}', String(2000))
-        .replaceAll('${maxBytes}', String(50 * 1024)),
-    inputSchema: bashInputSchema
-}, async (args) => {
-    try {
-        const result = await executeBash({ ...args });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(result) }],
-            structuredContent: result
-        };
-    }
-    catch (error) {
-        return {
-            isError: true,
-            content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }]
-        };
-    }
-});
-// =============================================================================
-// Start Server
-// =============================================================================
+(0, bash_1.registerBashTool)(server);
+(0, ls_1.registerLsTool)(server);
+(0, glob_1.registerGlobTool)(server);
+(0, grep_1.registerGrepTool)(server);
 const transport = new stdio_js_1.StdioServerTransport();
 server.connect(transport);
 console.error(`${MCP_NAME} Server v${MCP_VERSION} running`);

package/dist/ls.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerLsTool(server: McpServer): void;

package/dist/ls.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLsTool = registerLsTool;
+const ls_txt_1 = __importDefault(require("../descriptions/ls.txt"));
+const zod_1 = __importDefault(require("zod"));
+const path_1 = __importDefault(require("path"));
+const mcp_helpers_1 = require("@baitong-dev/mcp-helpers");
+const IGNORE_PATTERNS = [
+    'node_modules/',
+    '__pycache__/',
+    '.git/',
+    'dist/',
+    'build/',
+    'target/',
+    'vendor/',
+    'bin/',
+    'obj/',
+    '.idea/',
+    '.vscode/',
+    '.zig-cache/',
+    'zig-out',
+    '.coverage',
+    'coverage/',
+    'vendor/',
+    'tmp/',
+    'temp/',
+    '.cache/',
+    'cache/',
+    'logs/',
+    '.venv/',
+    'venv/',
+    'env/'
+];
+const FILE_LIMIT = 100;
+function registerLsTool(server) {
+    server.registerTool('ls', {
+        description: ls_txt_1.default,
+        inputSchema: zod_1.default.object({
+            path: zod_1.default
+                .string()
+                .describe('The absolute path to the directory to list (must be absolute, not relative)')
+                .optional(),
+            ignore: zod_1.default.array(zod_1.default.string()).describe('List of glob patterns to ignore').optional()
+        })
+    }, async (args) => {
+        const searchPath = path_1.default.resolve(mcp_helpers_1.MCP_WORKSPACE_DIR, args.path || '.');
+        const ignoreGlobs = IGNORE_PATTERNS.map(p => `!${p}*`).concat(args.ignore?.map(p => `!${p}`) || []);
+        const files = [];
+        const rgFiles = await mcp_helpers_1.Ripgrep.files({
+            cwd: searchPath,
+            glob: ignoreGlobs
+        });
+        for (const file of rgFiles) {
+            files.push(file);
+            if (files.length >= FILE_LIMIT)
+                break;
+        }
+        // Build directory structure
+        const dirs = new Set();
+        const filesByDir = new Map();
+        for (const file of files) {
+            const dir = path_1.default.dirname(file);
+            const parts = dir === '.' ? [] : dir.split('/');
+            // Add all parent directories
+            for (let i = 0; i <= parts.length; i++) {
+                const dirPath = i === 0 ? '.' : parts.slice(0, i).join('/');
+                dirs.add(dirPath);
+            }
+            // Add file to its directory
+            if (!filesByDir.has(dir))
+                filesByDir.set(dir, []);
+            filesByDir.get(dir).push(path_1.default.basename(file));
+        }
+        function renderDir(dirPath, depth) {
+            const indent = '  '.repeat(depth);
+            let output = '';
+            if (depth > 0) {
+                output += `${indent}${path_1.default.basename(dirPath)}/\n`;
+            }
+            const childIndent = '  '.repeat(depth + 1);
+            const children = Array.from(dirs)
+                .filter(d => path_1.default.dirname(d) === dirPath && d !== dirPath)
+                .sort();
+            // Render subdirectories first
+            for (const child of children) {
+                output += renderDir(child, depth + 1);
+            }
+            // Render files
+            const files = filesByDir.get(dirPath) || [];
+            for (const file of files.sort()) {
+                output += `${childIndent}${file}\n`;
+            }
+            return output;
+        }
+        const result = {
+            title: path_1.default.relative(mcp_helpers_1.MCP_WORKSPACE_DIR, searchPath),
+            metadata: {
+                count: files.length,
+                truncated: files.length >= FILE_LIMIT
+            },
+            output: `${searchPath}/\n` + renderDir('.', 0)
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+            structuredContent: result
+        };
+    });
+}

package/package.json

@@ -1,18 +1,19 @@
 {
   "name": "@baitong-dev/bash-mcp",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "main": "./dist/index.js",
   "bin": {
     "@baitong-dev/bash-mcp": "./dist/index.js"
   },
   "files": [
     "dist",
-    "bash.txt",
+    "descriptions",
     "README.md"
   ],
   "keywords": [
     "mcp",
-    "bash"
+    "bash",
+    "ls"
   ],
   "description": "bash-mcp",
   "dependencies": {
@@ -20,7 +21,10 @@
     "tree-sitter-bash": "^0.25.1",
     "web-tree-sitter": "^0.26.5",
     "zod": "^4.3.4",
-    "@baitong-dev/mcp-helpers": "0.0.1"
+    "@baitong-dev/mcp-helpers": "0.0.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
   },
   "publishConfig": {
     "access": "public",