Available Tools
file_read
Read file contents
file_write
Write or create files
file_list
List directory contents
file_search
Search file contents with regex
file_read
Read the contents of a file within the workspace.Parameters
string
required
Relative or absolute path to the file. Must be within workspace.
Example
Response
Returns file contents as a string. Binary files are base64-encoded.file_write
Write content to a file, creating it if it doesn’t exist.Parameters
string
required
Relative or absolute path to the file. Must be within workspace.
string
required
Content to write to the file
Example
Response
Returns success confirmation with file path.file_list
List files and directories within a path.Parameters
string
Directory path (defaults to workspace root)
boolean
List recursively (default: false)
Example
Response
Returns list of files with metadata (name, size, type, modified time).file_search
Search for text patterns in files using regex.Parameters
string
required
Regular expression pattern to search for
string
Directory to search (defaults to workspace root)
string
Glob pattern to filter files (e.g., “*.rs”)
Example
Response
Returns matches with file path, line number, and matching text.Security
Path Validation
- Resolves symlinks and checks canonical paths
- Blocks
..traversal outside workspace - Rejects absolute paths outside workspace
- Prevents access to sensitive system files
File Size Limits
- Read: 10MB maximum file size
- Write: 10MB maximum content size
- List: 10,000 file maximum per directory