原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

MCP Server Cloud Fs

作者:nogoo9版本 0.7.0i★ –i在你的电脑上运行
注册名称io.github.nogoo9/mcp-server-cloud-fs

安装

概览

作者提供的说明(英文原文)

Cloud replacement for mcp-server-filesystem — 20 tools for S3, Azure Blob, and GCS

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 在你的电脑上运行
  • 传输方式: stdio
  • 分类: 开发者工具
  • 你需要填写:AZURE_STORAGE_CONNECTION_STRING, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

  • 基础检查:1 项中通过 1 项
  • 在你的电脑上运行,拥有你的用户账户的权限(文件、网络、应用)。
  • 需要你自己填写: AZURE_STORAGE_CONNECTION_STRING, GOOGLE_CLOUD_PROJECT, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, REDIS_URL

标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。

你需要

  • npm已安装 Node.js(用于 npx 命令)

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "cloud-fs": {
      "command": "npx",
      "args": [
        "-y",
        "@nogoo9/mcp-server-cloud-fs"
      ],
      "env": {
        "AZURE_STORAGE_CONNECTION_STRING": "your-value",
        "GOOGLE_CLOUD_PROJECT": "your-value",
        "AWS_ACCESS_KEY_ID": "your-value",
        "AWS_SECRET_ACCESS_KEY": "your-value",
        "REDIS_URL": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add cloud-fs --env AZURE_STORAGE_CONNECTION_STRING=your-value --env GOOGLE_CLOUD_PROJECT=your-value --env AWS_ACCESS_KEY_ID=your-value --env AWS_SECRET_ACCESS_KEY=your-value --env REDIS_URL=your-value -- npx -y @nogoo9/mcp-server-cloud-fs

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "cloud-fs": {
      "command": "npx",
      "args": [
        "-y",
        "@nogoo9/mcp-server-cloud-fs"
      ],
      "env": {
        "AZURE_STORAGE_CONNECTION_STRING": "your-value",
        "GOOGLE_CLOUD_PROJECT": "your-value",
        "AWS_ACCESS_KEY_ID": "your-value",
        "AWS_SECRET_ACCESS_KEY": "your-value",
        "REDIS_URL": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "cloud-fs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nogoo9/mcp-server-cloud-fs"
      ],
      "env": {
        "AZURE_STORAGE_CONNECTION_STRING": "your-value",
        "GOOGLE_CLOUD_PROJECT": "your-value",
        "AWS_ACCESS_KEY_ID": "your-value",
        "AWS_SECRET_ACCESS_KEY": "your-value",
        "REDIS_URL": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上,无需账户。

需要你填写的值

  • AZURE_STORAGE_CONNECTION_STRING 机密 env
    Azure Blob Storage connection string (required when using the azure provider)
  • GOOGLE_CLOUD_PROJECT env
    Google Cloud project ID (optional when using the gcs provider)
  • AWS_ACCESS_KEY_ID 机密 env
    AWS Access Key ID (optional for S3 — falls back to ~/.aws/credentials or IAM role)
  • AWS_SECRET_ACCESS_KEY 机密 env
    AWS Secret Access Key (optional for S3 — falls back to ~/.aws/credentials or IAM role)
  • REDIS_URL env
    Redis connection URL (required when --cache-store redis, defaults to redis://localhost:6379)

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 nogoo9 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

与“开发者工具”中的其他服务器比较i

  • 星标数多于此分类中其他 1395 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 1395 个服务器的 22% 更新
  • 基础检查结果等于或优于此分类中其他 1395 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

MCP Server Cloud Fs 安全吗?

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:AZURE_STORAGE_CONNECTION_STRING, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(0.7.0)于6个月前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它?

同一分类中有:GitHub, Desktop Commander, Cloudflare MCP

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

GitHub

作者:github

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

电脑或云端★ 34,245MIT4天前更新
安装

Desktop Commander

作者:wonderwhy-er

MCP server for terminal commands, file operations, and process management

在你的电脑上运行★ 10,225MIT16天前更新
安装

Cloudflare MCP

作者:cloudflare

Cloudflare MCP servers

在云端运行★ 4,446Apache-2.014个月前更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

@nogoo9/mcp-server-cloud-fs

Cloud replacement for mcp-server-filesystem — 30 tools for S3, Azure Blob, and GCS.

Deploy locally via STDIO or remotely over HTTP/WebSocket with OAuth 2.1 auth.

Also available as an npm library and interactive TUI.

📖 Read the full documentation →

Providers: Amazon S3 · Azure Blob Storage · Google Cloud Storage · MinIO · RustFS · Cloudflare R2 · Backblaze B2 · Wasabi · LocalStack · SQLite · In-Memory


Table of Contents

  • What it does
  • Quick start
  • Interactive Shell
  • Transports
  • Authentication & Authorization
  • Production Features
  • CLI Reference
  • Provider Setup
  • MCP Client Config
  • Tool Reference
  • Architecture: VFS
  • Caching
  • Programmatic Usage
  • MCP Inspector
  • Development & Testing
  • AI Agent Skill
  • Documentation
  • License

What it does

@nogoo9/mcp-server-cloud-fs exposes all 14 tools defined by mcp-server-filesystem — same tool names, same parameter schemas — over cloud object storage. Drop it into any MCP client config that currently points at mcp-server-filesystem and your AI assistant gains read/write access to S3, Azure Blob Storage, or Google Cloud Storage buckets.

It also includes 5 extended tools inspired by claude-code's filesystem tool surface: line-range reads, byte-range chunk reads, in-process regex search (single file and multi-file), server-side copy, and opt-in deletion. Plus 6 cloud-native tools (presigned URLs, object metadata/tags, tag-based search, version history, version restore), 2 AI-native tools (schema extraction, file summarization), and 1 macro tool (patch_file for atomic diffs).

A Virtual Filesystem (VFS) layer provides FUSE-like cache coherence with ETag-based concurrency control, a shell tool lets you run POSIX-like commands (ls, grep, jq, cat | wc, etc.) against cloud storage, and the package is available as a programmatic npm library.

v0.7.0 Highlights
  • Dynamic tool surface reduction: scope-aware tool filtering — clients only see tools they're authorized to use
  • DLP content sanitization: regex-based middleware redacts PII, API keys, and credentials from tool responses (--enable-dlp)
  • AI-native tools: get_file_schema extracts CSV/JSON structure; summarize_file returns compact head/tail previews
  • ETag concurrency control: SHA-256 content-addressable ETags with expected_etag conflict detection on edit_file and patch_file
  • `patch_file` macro tool: atomic read-diff-write in a single tool call — supports unified diffs and line-range replacements
v0.6.0 Highlights
  • Cloud-native tools: presigned URLs, object metadata/tags, version history, version restore
  • Byte-range reads: read_file_chunk fetches specific byte ranges without downloading the full object
  • Structured audit logging: tool invocation audit trail with pluggable sinks (stderr, file)
  • Multi-provider routing: MultiProvider serves S3 + Azure + GCS from a single server instance
  • Azure Managed Identity: DefaultAzureCredential for OIDC and federated auth
  • Connection health-check: startup credential validation with diagnostic reporting
  • MCP Resources: browse cloud storage as native MCP Resources (no tool calls needed)
  • Structured errors: CloudError with typed codes and provider-specific error mappers
v0.5.0 Highlights
  • Interactive TUI (`cloud-fs`): Terminal shell with cd, tab completion, and command history
  • Multi-transport: STDIO (default), Streamable HTTP, and WebSocket
  • Dual runtime: Bun-native and Node.js support (HTTP transport + SQLite provider)
  • OAuth 2.1: Built-in auth server or external IdP token validation
  • ext-auth extensions: Client Credentials (M2M) and Enterprise-Managed Authorization (SSO)
  • Production hardening: Rate limiting, CORS, security headers, health checks, structured logging
  • AI agent skill: Installable skills/cloud-fs for Claude Code, Gemini CLI, and other AI assistants

Quick start

Local (STDIO — default)
npx @nogoo9/mcp-server-cloud-fs s3 s3://my-bucket
Remote (HTTP)
# Bun (zero Express dependency)

bunx @nogoo9/mcp-server-cloud-fs s3 s3://my-bucket --transport http --port 3000

Node.js (requires express peer dep)

npx @nogoo9/mcp-server-cloud-fs s3 s3://my-bucket --transport http --port 3000

Remote (WebSocket — Bun only)
bunx @nogoo9/mcp-server-cloud-fs s3 s3://my-bucket --transport ws --port 3000
Demo (no cloud credentials needed)
bunx @nogoo9/mcp-server-cloud-fs memory mem://demo --enable-shell --seed-demo

Interactive Shell (cloud-fs)

Drop into an interactive terminal for exploring and managing cloud storage — no MCP client needed:

# S3

npx -p @nogoo9/mcp-server-cloud-fs cloud-fs s3 s3://my-bucket

In-memory demo with sample files

npx -p @nogoo9/mcp-server-cloud-fs cloud-fs memory mem://demo --seed-demo

With a config file (cloud-fs.json in CWD)

npx -p @nogoo9/mcp-server-cloud-fs cloud-fs

Features
  • `cd` navigation — cd data, cd .., cd / with dynamic prompt showing current directory
  • Tab completion — context-aware path and command completion
  • Command history — persistent across sessions (~/.cloud-fs_history)
  • Relative paths — all commands resolve relative to cwd, just like a real shell
  • 19 built-in commands — ls, cat, head, tail, cp, mv, rm, mkdir, touch, stat, find, grep, wc, du, echo, tee, diff, jq, cd
  • Pipes & redirects — cat config.json | jq '.database', echo hello > file.txt
Local development
bun src/cli-tui.ts memory mem://demo --seed-demo

Transports

The server supports three MCP transports, selected via --transport:

TransportFlagRuntimeUse case
STDIO--transport stdio (default)Bun, NodeLocal npx, Claude Desktop, Claude Code
Streamable HTTP--transport httpBun ✅, Node ✅Remote deployment, multi-user, enterprise
WebSocket--transport wsBun onlyLow-latency bidirectional, real-time apps
Streamable HTTP

Implements the MCP Streamable HTTP specification with a single /mcp endpoint for POST (requests), GET (SSE notifications), and DELETE (session termination).

Dual runtime support:

  • Bun: Uses WebStandardStreamableHTTPServerTransport with Bun.serve() directly — zero Express dependency, maximum performance.
  • Node.js: Falls back to StreamableHTTPServerTransport with Express. Requires express as an optional peer dependency (npm install express).

Runtime is auto-detected at startup.

Session management:

Sessions use UUID v7 (RFC 9562) — time-ordered and K-sortable, making them ideal for logging, debugging, and database indexing. Sessions are tracked via the Mcp-Session-Id header.

Resumability:

When an EventStore is configured, clients can reconnect and resume receiving messages from where they left off via the Last-Event-ID SSE header.

# Basic HTTP server

cloud-fs-mcp s3 s3://my-bucket --transport http --port 3000

With authentication

cloud-fs-mcp s3 s3://my-bucket --transport http --port 3000 --auth builtin --auth-issuer https://my-server.example.com

Production deployment

cloud-fs-mcp s3 s3://my-bucket \ --transport http --port 3000 --host 0.0.0.0 \ --auth external --auth-jwks-uri https://login.example.com/.well-known/jwks.json \ --cors-origin https://app.example.com \ --rate-limit 60 --rate-limit-burst 10 \ --security-headers \ --request-logging

WebSocket

Bun-native WebSocket transport using Bun.serve() with WebSocket upgrade handling. Provides lower latency than HTTP for high-frequency tool invocations.

  • JSON-RPC message framing over WebSocket
  • UUID v7 session assigned on upgrade
  • WS ping/pong heartbeat for connection liveness
cloud-fs-mcp s3 s3://my-bucket --transport ws --port 3000

Authentication & Authorization

Authentication is disabled by default and only applies to HTTP/WS transports. STDIO mode never requires auth.

Auth modes
ModeFlagDescription
none--auth none (default)No authentication. Suitable for local/trusted networks.
builtin--auth builtinSelf-hosted OAuth 2.1 Authorization Server. The MCP server acts as both AS and RS.
external--auth externalValidate bearer tokens against an external IdP (Okta, Auth0, Keycloak, Azure AD).
Built-in OAuth server (--auth builtin)

The server runs a full OAuth 2.1 Authorization Server using the MCP SDK's mcpAuthRouter():

  • Authorization Code + PKCE (mandatory) — interactive user consent flow
  • Dynamic Client Registration — MCP clients auto-register on first connect
  • Refresh token rotation — single-use refresh tokens prevent replay
  • Metadata discovery — /.well-known/oauth-authorization-server (RFC 8414) and /.well-known/oauth-protected-resource (RFC 9728)
cloud-fs-mcp s3 s3://my-bucket \

--transport http --port 3000 \ --auth builtin --auth-issuer https://my-server.example.com

External IdP (--auth external)

The server only validates bearer tokens — it does not issue tokens. Use this when you have an existing identity provider.

  • JWKS validation — fetches and caches signing keys from your IdP
  • JWT verification — checks signature, issuer,

只显示了开头部分;其余内容请在仓库中阅读

问 PopNx