File Finder MCP

Example Use Cases

• 1

  Locate files on a host system by partial path or filename and retrieve metadata for processing or display.

• 2

  Restrict file searches to a specific directory (for example, a project or user workspace) to reduce noise and surface relevant files.

• 3

  Index or audit local files by collecting file names, full paths, sizes, and creation dates for downstream workflows.

Description

This MCP server exposes a single tool, search-files, which finds files whose paths match a provided query and returns metadata including name, full path, size, and creation date. It supports restricting searches to a specified base directory (defaults to root) and is intended for integration into agent workflows. The server is configured locally via a simple command/args entry and is useful for quickly adding filesystem discovery capabilities to multi-component agents.