Docsmcp
Filesystem MCP Server
Read and write files on the local server disk from workflows
The Filesystem MCP server provides tools for reading and writing files on the FlowTrux server's local disk. This is useful for generating reports, processing data files, or interacting with shared directories.
Setup
- Go to Settings > MCP Servers > Add Server.
- Select Filesystem.
- Configure the following:
| Field | Required | Description |
|---|---|---|
outputDir | Yes | Base directory for file writes (e.g., /data/output) |
allowedDirs | Yes | Comma-separated list of directories the server can access (e.g., /data/output,/data/reports,/data/imports) |
- Click Save.
Use absolute paths. Do not use ~ for the home directory.
Security
The server enforces directory restrictions:
- All file operations are validated against the
allowedDirslist. - Attempting to read, write, or delete a file outside the allowed directories will fail.
- Path traversal attempts (e.g.,
../../etc/passwd) are blocked.
Tools
write_file
Write text content to a file. Creates parent directories if they do not exist.
| Parameter | Type | Required | Description |
|---|---|---|---|
filename | string | Yes | File name (placed in the output directory) |
content | string | Yes | File content to write |
directory | string | No | Subdirectory within the output folder |
write_binary
Write base64-encoded binary content to a file.
| Parameter | Type | Required | Description |
|---|---|---|---|
filename | string | Yes | File name (e.g., image.png, backup.zip) |
base64_content | string | Yes | Base64-encoded content |
directory | string | No | Subdirectory within the output folder |
read_file
Read content from a file.
| Parameter | Type | Required | Description |
|---|---|---|---|
filepath | string | Yes | Path to the file (relative to allowed directories) |
list_files
List files in a directory.
| Parameter | Type | Required | Description |
|---|---|---|---|
directory | string | No | Directory path (default: output directory) |
pattern | string | No | Filter pattern (e.g., *.json) |
delete_file
Delete a file.
| Parameter | Type | Required | Description |
|---|---|---|---|
filepath | string | Yes | Path to the file to delete |
append_to_file
Append content to an existing file. Creates the file if it does not exist.
| Parameter | Type | Required | Description |
|---|---|---|---|
filename | string | Yes | File name |
content | string | Yes | Content to append |
directory | string | No | Subdirectory within the output folder |
Filesystem vs Files (S3)
| Feature | Filesystem | Files (S3) |
|---|---|---|
| Storage location | Server disk | S3-compatible cloud storage |
| Organization scoping | Manual via allowedDirs | Automatic by org/workspace |
| Shareable URLs | No | Yes (presigned URLs) |
| Persistence | Depends on server | Durable cloud storage |
| Best for | Local processing, temp files | Permanent storage, sharing |