
Mcp Server Cloud Fs
Drops into S3, Azure Blob Storage, and Google Cloud Storage with the same 14-tool interface as the standard mcp-server-filesystem, so you can swap it into existing configs without changing tool names or parameters. Adds 16 more tools on top: line-range and byte-range reads, regex search across files, presigned URLs, object metadata and tagging, version history and restore, plus AI-focused helpers like schema extraction and file summarization. Ships with a VFS layer for ETag-based concurrency control, an interactive TUI shell for exploring buckets without an MCP client, and dual runtime support for both Bun and Node.js. Supports local STDIO, remote HTTP/WebSocket, and OAuth 2.1 for production deployments. Reach for this when you need cloud-native file operations in Claude or want to give your AI assistant direct bucket access with the same semantics as local filesystem tools.
- GitHub stars
- 2
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env vars
- 5
- last updated
- May 18, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
read_fileRead a file. Binary → base64; text → UTF-8.
Read a file. Binary → base64; text → UTF-8.
No parameter schema in public metadata yet.
read_text_fileRead text file with optional head/tail line limits.
Read text file with optional head/tail line limits.
No parameter schema in public metadata yet.
read_media_fileRead image/media as base64 MCP image content block.
Read image/media as base64 MCP image content block.
No parameter schema in public metadata yet.
read_multiple_filesRead several files in parallel.
Read several files in parallel.
No parameter schema in public metadata yet.
read_file_rangeRead a 1-based line range with total line count header.
Read a 1-based line range with total line count header.
No parameter schema in public metadata yet.
read_file_chunkRead a byte range without downloading the entire file. Max 10MB.
Read a byte range without downloading the entire file. Max 10MB.
No parameter schema in public metadata yet.
write_fileWrite/overwrite a file. Flushed after debounce window.
Write/overwrite a file. Flushed after debounce window.
No parameter schema in public metadata yet.
edit_fileApply { oldText, newText } edits. Preview with dryRun. Optional ETag conflict detection.
Apply { oldText, newText } edits. Preview with dryRun. Optional ETag conflict detection.
No parameter schema in public metadata yet.
create_directoryCreate a directory placeholder and parent prefixes.
Create a directory placeholder and parent prefixes.
No parameter schema in public metadata yet.
list_directoryList immediate children (like ls).
List immediate children (like ls).
No parameter schema in public metadata yet.
list_directory_with_sizesList children with sizes. Sort by size or name.
List children with sizes. Sort by size or name.
No parameter schema in public metadata yet.
directory_treeRecursive directory tree with glob exclusions.
Recursive directory tree with glob exclusions.
No parameter schema in public metadata yet.
move_fileMove file. Server-side copy + delete for same-bucket.
Move file. Server-side copy + delete for same-bucket.
No parameter schema in public metadata yet.
copy_fileCopy file. Server-side for same-bucket.
Copy file. Server-side for same-bucket.
No parameter schema in public metadata yet.
delete_fileDelete file. Requires --enable-delete.
Delete file. Requires --enable-delete.
No parameter schema in public metadata yet.
search_filesGlob-based object key search.
Glob-based object key search.
No parameter schema in public metadata yet.
grep_fileRegex search in a single file with line numbers.
Regex search in a single file with line numbers.
No parameter schema in public metadata yet.
grep_filesRegex search across all objects under a path.
Regex search across all objects under a path.
No parameter schema in public metadata yet.
get_file_infoFile metadata: size, last-modified, content type.
File metadata: size, last-modified, content type.
No parameter schema in public metadata yet.
list_allowed_directoriesList configured root URIs.
List configured root URIs.
No parameter schema in public metadata yet.
get_presigned_urlGenerate a temporary access URL (default: GET, 1 hour).
Generate a temporary access URL (default: GET, 1 hour).
No parameter schema in public metadata yet.
get_object_metadataSize, content type, last modified, custom metadata, and tags.
Size, content type, last modified, custom metadata, and tags.
No parameter schema in public metadata yet.
set_object_tagsReplace object tags with key-value pairs.
Replace object tags with key-value pairs.
No parameter schema in public metadata yet.
search_by_tagFind objects matching tag filters (AND logic).
Find objects matching tag filters (AND logic).
No parameter schema in public metadata yet.
list_versionsVersion history with timestamps, sizes, and markers.
Version history with timestamps, sizes, and markers.
No parameter schema in public metadata yet.
restore_versionRestore a previous object version (copies over current).
Restore a previous object version (copies over current).
No parameter schema in public metadata yet.
get_file_schemaExtract structural schema: CSV column names/types/samples, JSON shape, or text line/byte counts.
Extract structural schema: CSV column names/types/samples, JSON shape, or text line/byte counts.
No parameter schema in public metadata yet.
summarize_fileCompact head/tail preview with file size, line count, and content type.
Compact head/tail preview with file size, line count, and content type.
No parameter schema in public metadata yet.
patch_fileApply unified diffs or line-range replacements atomically in a single tool call.
Apply unified diffs or line-range replacements atomically in a single tool call.
No parameter schema in public metadata yet.
shellExecute POSIX-like commands. Supports pipes, redirects. Requires --enable-shell.
Execute POSIX-like commands. Supports pipes, redirects. Requires --enable-shell.
No parameter schema in public metadata yet.
Sponsors
Configuration
AZURE_STORAGE_CONNECTION_STRINGsecretAzure Blob Storage connection string (required when using the azure provider)
GOOGLE_CLOUD_PROJECTGoogle Cloud project ID (optional when using the gcs provider)
AWS_ACCESS_KEY_IDsecretAWS Access Key ID (optional for S3 — falls back to ~/.aws/credentials or IAM role)
AWS_SECRET_ACCESS_KEYsecretAWS Secret Access Key (optional for S3 — falls back to ~/.aws/credentials or IAM role)
REDIS_URLRedis connection URL (required when --cache-store redis, defaults to redis://localhost:6379)
Readme
Details
- Repository
- github.com/nogoo9/mcp-server-cloud-fs
- Categories
- Cloud & Infrastructure, Developer Tools
- Package
@nogoo9/mcp-server-cloud-fs- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active