search_files

Search for files and directories recursively by matching a pattern, starting from a specified path. Returns full paths to matches, supporting case-insensitive and partial name searches. Automatically excludes unwanted items and operates within secure directory boundaries.

Instructions

Recursively search for files and directories matching a pattern. Searches through all subdirectories from the starting path. The search is case-insensitive and matches partial names. Returns full paths to all matching items. Great for finding files when you don't know their exact location. Only searches within allowed directories.

Input Schema

Name	Required	Description
`excludePatterns`	No	Patterns to exclude from search results
`path`	Yes	Root path to start searching from
`pattern`	Yes	Pattern to match against filenames and directories

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "excludePatterns": {
      "default": [],
      "description": "Patterns to exclude from search results",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "path": {
      "description": "Root path to start searching from",
      "type": "string"
    },
    "pattern": {
      "description": "Pattern to match against filenames and directories",
      "type": "string"
    }
  },
  "required": [
    "path",
    "pattern"
  ],
  "type": "object"
}

MCP Filesystem Server

search_files

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP Filesystem Server

Related Tools

MCP directory API