grep

Search for text patterns in files using regular expressions, recursively explore directories, and filter results based on file exclusions, while respecting .gitignore and file permissions.

Instructions

Search for text patterns inside files using regular expressions.

Args: dir (str): Directory to search in (absolute or relative to allowed directories) pattern (str): Regular expression pattern to search for in file contents exclude (str, optional): File pattern to exclude from search

Returns: str: Newline-separated matches in format 'path:lineNo: line', or error message if failed

Note:

- Directory must be within allowed directory roots
- Searches recursively through subdirectories
- Only searches UTF-8 text files
- Respects .gitignore files and skips common lock files
- Each match shows file path, line number, and the matching line
- Uses Python regular expression syntax

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

grep

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Filesystem MCP Server

Related Tools

MCP directory API