nogoo9 avatar

Mcp Server Cloud Fs

nogoo9/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 tools

Public 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_STRINGsecret

Azure Blob Storage connection string (required when using the azure provider)

GOOGLE_CLOUD_PROJECT

Google Cloud project ID (optional when using the gcs provider)

AWS_ACCESS_KEY_IDsecret

AWS Access Key ID (optional for S3 — falls back to ~/.aws/credentials or IAM role)

AWS_SECRET_ACCESS_KEYsecret

AWS Secret Access Key (optional for S3 — falls back to ~/.aws/credentials or IAM role)

REDIS_URL

Redis connection URL (required when --cache-store redis, defaults to redis://localhost:6379)

Readme

nogoo9

@nogoo9/mcp-server-cloud-fs


View the full README on GitHub

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

More from nogoo9

Related Cloud & Infrastructure MCP servers

View all
1galadriel-tech-solutions avatarCloudpulsegaladriel-tech-solutions/cloudpulse-mcpCross-cloud observability for AI agents. Covers AWS, GCP, Vercel, and Cloudflare.1stars
2synlake avatarSynlakeai.synlake/synlakeUnified API to query AWS, GCP, Azure and generate Terraform/CLI execution kits for AI agents.0stars
3luthersystems avatarInsideOut (Riley)luthersystems/insideout-agent-skillsDesigns, prices, and deploys AWS/GCP cloud infrastructure from plain-English requirements.0stars
4alexpota avatarCloudscopealexpota/cloudscope-mcpAzure + GCP cost management: spending, forecasts, anomalies, budgets, idle resources, and tags.0stars
5cloudforgetech6-ctrl avatarCloudforgecloudforgetech6-ctrl/mcp_serverVisualise diagrams, generate Terraform HCL, and manage Azure/AWS/GCP infrastructure with AI.0stars
6jasonwilbur avatarCloud Regionsjasonwilbur/mcp-server-cloud-regionsCloud region data for AWS, Azure, GCP, OCI & more. Query by location, compliance, GPU.0stars