search_files

Search for files by name pattern within a specified directory and its subdirectories, respecting exclusions and .gitignore rules. Returns matching absolute file paths or an error message.

Instructions

Search for files by name pattern in a directory recursively.

Args: dir (str): Directory to search in (absolute or relative to allowed directories) pattern (str): Glob-style pattern to match file names (e.g., '.py', 'test_') exclude (str, optional): Glob-style pattern to exclude file names

Returns: List[str] | str: List of matching absolute file paths, or error message if failed

Note:

- Directory must be within allowed directory roots
- Searches recursively through subdirectories
- Respects .gitignore files, and ignores hidden files and folders
- Returns list for successful searches, string for errors

Input Schema

Name	Required	Description	Default
`dir`	Yes
`exclude`	No
`pattern`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "dir": {
      "title": "Dir",
      "type": "string"
    },
    "exclude": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exclude"
    },
    "pattern": {
      "title": "Pattern",
      "type": "string"
    }
  },
  "required": [
    "dir",
    "pattern"
  ],
  "type": "object"
}

Filesystem MCP Server

search_files

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Filesystem MCP Server

Related Tools

MCP directory API