GonMCPtool

Instructions

Implementation Reference

• main.ts:479-509 (registration)

  Registration of the 'find_files' tool, including inline Zod schema for input validation and thin handler that delegates to FileSearchTool for actual searching.
  server.tool("find_files", "在允許的目錄中找尋所有符合檔名模式的檔案並標示其檔案路徑", { filePattern: z.string(), excludeDirs: z.array(z.string()).optional() }, async ({ filePattern, excludeDirs = ['node_modules', '.git', 'dist', 'bin', 'obj'] }) => { try { // 獲取允許的目錄列表 const allowedDirs = await FileSearchTool.getAllowedDirectories(); // 檢查是否有允許的目錄 if (allowedDirs.length === 0) { return { content: [{ type: "text", text: '錯誤：未提供允許的目錄參數。請在啟動時指定至少一個允許的目錄。' }] }; } // 在允許的目錄中搜尋檔案 const result = await FileSearchTool.searchFilesInAllowedDirs(allowedDirs, filePattern, excludeDirs); return { content: [{ type: "text", text: result }] }; } catch (error) { return { content: [{ type: "text", text: `搜尋檔案失敗: ${error instanceof Error ? error.message : "未知錯誤"}` }] }; } } );
• tools/fileSearchTool.ts:71-110 (helper)

  Core helper method called by the tool handler to search for files matching the pattern across allowed directories, formats and returns the results as a string.
  public static async searchFilesInAllowedDirs( allowedDirs: string[], filePattern: string, excludeDirs: string[] = ['node_modules', '.git', 'dist', 'bin', 'obj'] ): Promise<string> { try { if (!filePattern) { return '錯誤: 請提供檔名模式'; } // 檢查是否有允許的目錄 if (allowedDirs.length === 0) { return '錯誤：未提供允許的目錄參數。請在啟動時指定至少一個允許的目錄。'; } let allResults: string[] = []; for (const dir of allowedDirs) { // 檢查目錄是否存在 if (!fs.existsSync(dir)) { continue; } const results = await this.searchFiles(dir, filePattern, excludeDirs); allResults = allResults.concat(results); } if (allResults.length === 0) { return `未找到符合模式 "${filePattern}" 的檔案`; } // 將搜尋結果格式化為字串 const formattedResults = allResults .map((filePath, index) => `${index + 1}. ${filePath}`) .join('\n'); return `找到 ${allResults.length} 個符合模式 "${filePattern}" 的檔案：\n${formattedResults}`; } catch (error) { return `搜尋檔案失敗: ${error instanceof Error ? error.message : '未知錯誤'}`; } }
• tools/fileSearchTool.ts:16-62 (helper)

  Recursive file search implementation that traverses directories, skips excluded dirs, and collects files matching the pattern using a regex converted from wildcard.
  public static async searchFiles( rootDir: string, filePattern: string, excludeDirs: string[] = [] ): Promise<string[]> { const readdir = util.promisify(fs.readdir); const stat = util.promisify(fs.stat); const results: string[] = []; // 將文件模式轉換為正則表達式 const patternRegex = this.convertPatternToRegex(filePattern); // 遞迴搜尋函數 async function searchDir(dir: string) { try { // 檢查是否有權限讀取目錄 await util.promisify(fs.access)(dir, fs.constants.R_OK); const files = await readdir(dir); for (const file of files) { // 跳過排除的目錄 if (excludeDirs.includes(file)) { continue; } const fullPath = path.join(dir, file); const fileStat = await stat(fullPath); if (fileStat.isDirectory()) { // 遞迴搜尋子目錄 await searchDir(fullPath); } else if (patternRegex.test(file)) { // 檔名符合模式 results.push(fullPath); } } } catch (error) { // 忽略讀取目錄失敗的錯誤 console.error(`無法讀取目錄 ${dir}: ${error instanceof Error ? error.message : '未知錯誤'}`); } } // 開始搜尋 await searchDir(rootDir); return results; }
• tools/fileSearchTool.ts:131-147 (helper)

  Helper method to retrieve allowed directories from command-line arguments, returns empty array if none provided.
  public static async getAllowedDirectories(): Promise<string[]> { // 從命令行參數獲取允許的目錄（從第2個參數開始，因為第1個是Node路徑，第2個是腳本路徑） const args = process.argv.slice(2); // 如果命令行中有額外參數，則這些參數被視為允許的目錄 if (args && args.length > 0) { return args; } // 因沒有提供命令行參數，因此回報錯誤 console.error('錯誤：未提供允許的目錄參數。請在啟動時指定至少一個允許的目錄。'); console.error('使用範例：'); console.error('node [dist路徑]/main.js "C:\\path\\to\\allowed\\directory1" "C:\\path\\to\\allowed\\directory2"'); // 返回空陣列，表示沒有允許的目錄 return []; }
• tools/fileSearchTool.ts:117-125 (helper)

  Utility method to convert simple wildcard patterns (*, ?) to case-insensitive regex for filename matching.
  private static convertPatternToRegex(pattern: string): RegExp { // 轉義特殊字符 let regexPattern = pattern .replace(/[.+^${}()|[\]\\]/g, '\\$&') .replace(/\*/g, '.*') // * 轉換為 .* .replace(/\?/g, '.'); // ? 轉換為 . return new RegExp(`^${regexPattern}$`, 'i'); // 不區分大小寫 }