search_files

Search for files and directories matching a pattern recursively. Supports content matching, exclusion rules, and custom output formats (text or JSON). Ideal for locating specific data within complex filesystems.

Instructions

Recursively search for files and directories matching a pattern.

Args:
    path: Starting directory
    pattern: Glob pattern to match against filenames
    recursive: Whether to search subdirectories
    exclude_patterns: Optional patterns to exclude
    content_match: Optional text to search within files
    max_results: Maximum number of results to return
    format: Output format ('text' or 'json')
    ctx: MCP context

Returns:
    Search results

Input Schema

Name	Required	Default
`content_match`	No
`exclude_patterns`	No
`format`	No	text
`max_results`	No
`path`	Yes
`pattern`	Yes
`recursive`	No

Input Schema (JSON Schema)

{
  "properties": {
    "content_match": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content Match"
    },
    "exclude_patterns": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exclude Patterns"
    },
    "format": {
      "default": "text",
      "title": "Format",
      "type": "string"
    },
    "max_results": {
      "default": 100,
      "title": "Max Results",
      "type": "integer"
    },
    "path": {
      "title": "Path",
      "type": "string"
    },
    "pattern": {
      "title": "Pattern",
      "type": "string"
    },
    "recursive": {
      "default": true,
      "title": "Recursive",
      "type": "boolean"
    }
  },
  "required": [
    "path",
    "pattern"
  ],
  "title": "search_filesArguments",
  "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