ssh_find
Search for files on a remote SSH host using structured parameters. Specify directory, filename pattern, type, size, and other filters without writing find syntax.
Instructions
Search for files on a remote host. Wraps the find command with structured parameters so you don't have to construct find syntax manually.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | SSH hostname or IP address | |
| port | No | SSH port (default: 22) | |
| username | No | SSH username (default: current user) | |
| privateKeyPath | No | Path to SSH private key | |
| password | No | SSH password. STRONGLY prefer key-based auth (privateKeyPath or ssh-agent). Passwords pass through MCP protocol frames as plaintext and may be logged by the transport or host process. | |
| path | Yes | Directory to search in (e.g. /var/log, /home/user) | |
| name | No | Filename pattern with wildcards (e.g. '*.log', 'config.*') | |
| type | No | File type: f=file, d=directory, l=symlink | |
| maxdepth | No | Maximum directory depth to search | |
| minsize | No | Minimum file size (e.g. '1M', '100k') | |
| maxsize | No | Maximum file size (e.g. '10M', '500k') | |
| newer | No | Reference file path -- find matches files modified more recently than this file | |
| timeout | No | Command timeout in milliseconds (default: 30000) |