search_files
Find files and directories matching patterns across subdirectories from a specified path within allowed locations.
Instructions
Recursively search for files and directories matching a pattern. Searches through all subdirectories from the starting path. Only searches within allowed directories.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| pattern | Yes |
Implementation Reference
- src/tools/filesystem.ts:107-135 (handler)The core handler function that recursively searches files matching the given pattern within the allowed directories starting from rootPath.
export async function searchFiles(rootPath: string, pattern: string): Promise<string[]> { const results: string[] = []; async function search(currentPath: string) { const entries = await fs.readdir(currentPath, { withFileTypes: true }); for (const entry of entries) { const fullPath = path.join(currentPath, entry.name); try { await validatePath(fullPath); if (entry.name.toLowerCase().includes(pattern.toLowerCase())) { results.push(fullPath); } if (entry.isDirectory()) { await search(fullPath); } } catch (error) { continue; } } } const validPath = await validatePath(rootPath); await search(validPath); return results; } - src/tools/schemas.ts:58-61 (schema)Zod schema defining the input arguments for the search_files tool: path (starting directory) and pattern (search string).
export const SearchFilesArgsSchema = z.object({ path: z.string(), pattern: z.string(), }); - src/server.ts:172-178 (registration)Tool registration in the list of available tools, specifying name, description, and input schema.
{ name: "search_files", description: "Recursively search for files and directories matching a pattern. " + "Searches through all subdirectories from the starting path. " + "Only searches within allowed directories.", inputSchema: zodToJsonSchema(SearchFilesArgsSchema), - src/server.ts:308-313 (handler)Dispatch handler in the main tool call switch statement that parses arguments and invokes the searchFiles function.
case "search_files": { const parsed = SearchFilesArgsSchema.parse(args); const results = await searchFiles(parsed.path, parsed.pattern); return { content: [{ type: "text", text: results.length > 0 ? results.join('\n') : "No matches found" }], };