Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@urirun-connector-mcp-filesystem list files in /home/user/project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Sandboxed filesystem connector for ifURI / urirun, in the spirit of MCP filesystem servers. Query routes list/read/stat/find duplicates under one root. The guarded move command is also sandboxed and defaults to dry-run.
Catalog page: https://connect.ifuri.com/connectors/mcp-filesystem
URI | Operation |
| list a directory |
| read a text file (size-capped) |
| read a binary file as base64 (size-capped) |
| stat a path |
| remove empty directories under a sandboxed path |
| find exact duplicate files by SHA-256 |
| write a UTF-8 text file under the sandbox root |
| write a base64-decoded binary file under the sandbox root |
| move one file into a sandboxed directory |
| move or rename one file to a sandboxed path |
Related MCP server: MCP File Server
Everything resolves under IFURI_FS_ROOT (default: the current working
directory). Paths that escape the root are rejected with ok: false.
Query routes never write or delete. fs://host/dir/command/prune_empty,
fs://host/file/command/write_text, fs://host/file/command/write_blob,
fs://host/file/command/move_to_dir and
fs://host/file/command/move are the mutating routes; they default to
dry_run: true. File writes and moves do not overwrite unless
overwrite: true.
pip install "urirun-connector-mcp-filesystem @ git+https://github.com/if-uri/urirun-connector-mcp-filesystem.git@v0.1.0"
# or, from the hub:
urirun connectors install mcp-filesystem --executeexport IFURI_FS_ROOT="$PWD"
urirun-mcp-filesystem bindings > bindings.json
urirun compile bindings.json --out registry.json
urirun run 'fs://host/dir/query/list' registry.json \
--payload '{"path":"."}' --execute --allow 'fs://host/*'
urirun run 'fs://host/duplicates/query/find' registry.json \
--payload '{"path":".","extensions":"pdf,png,jpg"}' \
--execute --allow 'fs://host/*'
urirun run 'fs://host/file/query/blob' registry.json \
--payload '{"path":"2026.05/invoice.pdf","max_bytes":10485760}' \
--execute --allow 'fs://host/*'
urirun run 'fs://host/file/command/move_to_dir' registry.json \
--payload '{"path":"2026.05/manual.pdf","target_dir":"no_invoice","dry_run":true}' \
--execute --allow 'fs://host/*'
urirun run 'fs://host/file/command/move' registry.json \
--payload '{"path":"2026.05/_by_supplier/saas/me/invoice.pdf","target_path":"2026.05/2026.05.12-saas-invoice.pdf","dry_run":true}' \
--execute --allow 'fs://host/*'
urirun run 'fs://host/dir/command/prune_empty' registry.json \
--payload '{"path":".","exclude":"no_invoice","dry_run":true}' \
--execute --allow 'fs://host/*'
urirun run 'fs://host/file/command/write_text' registry.json \
--payload '{"path":"index.php","content":"<?php echo \"ok\";","dry_run":true}' \
--execute --allow 'fs://host/*'
urirun run 'fs://host/file/command/write_blob' registry.json \
--payload '{"path":"2026-06/invoice.pdf","bytes_b64":"JVBERg==","dry_run":true}' \
--execute --allow 'fs://host/*'After installation, urirun can discover this connector automatically through
the urirun.bindings entry-point group:
urirun discover --out connectors.bindings.json --registry-out connectors.registry.json
urirun list --entry-pointsThe connector projects to MCP tools and A2A skills like any other urirun
connector (python3 -m urirun.v2_mcp tools registry.json).
Released under the terms in LICENSE.
This server cannot be deployed
Manage files and folders directly from your workspace. Read and write files, list directories, cre…
Cloud file relay: chunked uploads, folders, share links, inline text reads, ZIP packing.
Sandbox workspace tools: search, file read, DB queries, integrations. Returns synthetic data.
Securely search and manage workspace context files for AI agents and teams.