Remote Filesystem

com.pulsemcp由 pulsemcp.com 發布v0.1.5更新於 Oct 24, 2026

MCP server for remote filesystem operations on cloud storage (Google Cloud Storage).

已驗證STDIO僅桌面雲端與基礎設施檔案與儲存

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓助理在 Google Cloud Storage 儲存桶中上傳、下載、列出、修改和刪除檔案。

可以做什麼
從本機路徑或 base64 資料上傳檔案到儲存桶路徑，可設為公開或指定內容類型與中繼資料。以文字或 base64 形式下載檔案，方便處理二進位資料。依前綴篩選並限制數量地列出檔案和目錄。修改檔案屬性，例如公開/私有、內容類型與自訂中繼資料，並為私有檔案產生簽章連結。從儲存桶中刪除檔案。
適用情境
適合助理需要讀寫 Google Cloud Storage 儲存桶中的檔案時使用，例如存放截圖、報告或產生的檔案，或讀取既有物件而不必另外上傳。唯讀模式適合只需檢視和取得檔案的助理。
執行需求
透過 npx 在本機執行，需要 Node.js。需要以 GCS_BUCKET 指定儲存桶名稱，並提供一種驗證方式：內嵌服務帳戶憑證（GCS_CLIENT_EMAIL 與 GCS_PRIVATE_KEY）、GOOGLE_APPLICATION_CREDENTIALS 指定的金鑰檔路徑，或應用程式預設憑證。選用設定包括 GCS_PROJECT_ID、GCS_ROOT_PATH、GCS_MAKE_PUBLIC 和 ENABLED_TOOLGROUPS。
安裝前請注意
需要 Google Cloud 服務帳戶私密金鑰，透過 GCS_PRIVATE_KEY 或金鑰檔提供，應視為敏感機密。此伺服器可上傳、修改和刪除儲存桶中的物件；建議以 ENABLED_TOOLGROUPS=readonly 和 GCS_ROOT_PATH 限制範圍。上傳或修改可能使檔案公開可存取，刪除的檔案可能無法復原。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Remote Filesystem，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Remote Filesystem MCP Server

An MCP server for remote filesystem operations on cloud storage providers. Currently supports Google Cloud Storage (GCS), with plans for S3, Cloudflare R2, and more.

Features

  • Upload files to cloud storage with public/private access control
  • Download files as text or base64 (for binary files)
  • List files and directories with prefix filtering
  • Modify file properties (public/private, content type, metadata)
  • Delete files from remote storage
  • Root path constraint to restrict access within bucket
  • Toolset groups for permission-based access control
  • Inline credentials support (no JSON key file needed)
  • Signed URL generation for private files

Installation

bash
npm install remote-filesystem-mcp-server

Or run directly with npx:

bash
npx remote-filesystem-mcp-server

Configuration

Environment Variables

VariableRequiredDescriptionDefault
GCS_BUCKETYesGCS bucket name-
GCS_PROJECT_IDNoGoogle Cloud project IDAuto
GCS_CLIENT_EMAILNo*Service account email (inline creds)-
GCS_PRIVATE_KEYNo*Service account private key (inline)-
GOOGLE_APPLICATION_CREDENTIALSNo*Path to service account key file-
GCS_ROOT_PATHNoRoot path prefix - restricts accessNone
GCS_MAKE_PUBLICNoMake files publicly accessiblefalse
ENABLED_TOOLGROUPSNoTool groups: readonly, readwriteAll

* One authentication method required: inline credentials OR key file OR ADC

Claude Desktop Configuration

json
{  "mcpServers": {    "remote-filesystem": {      "command": "npx",      "args": ["-y", "remote-filesystem-mcp-server"],      "env": {        "GCS_BUCKET": "your-bucket-name",        "GCS_CLIENT_EMAIL": "[email protected]",        "GCS_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...",        "GCS_ROOT_PATH": "uploads/"      }    }  }}

Tools

upload

Upload a file to the remote filesystem.

Parameters:

ParameterTypeRequiredDescription
sourcestringYesFile path (file://...) or base64 data
pathstringNoDestination path (auto-generated if none)
contentTypestringNoMIME type (auto-detected if not provided)
makePublicbooleanNoOverride default public/private setting

Example:

javascript
upload({  source: 'file:///tmp/screenshot.png',  path: 'screenshots/pr-123.png',  makePublic: true,});

download

Download a file from the remote filesystem.

Parameters:

ParameterTypeRequiredDescription
pathstringYesPath to the file
asBase64booleanNoReturn as base64 (for binary data)

Example:

javascript
download({  path: 'screenshots/pr-123.png',  asBase64: true,});

list_files

List files and directories in the remote filesystem.

Parameters:

ParameterTypeRequiredDescription
prefixstringNoDirectory prefix to list
maxResultsnumberNoMaximum files to return

Example:

javascript
list_files({  prefix: 'screenshots/',  maxResults: 100,});

modify

Modify file properties.

Parameters:

ParameterTypeRequiredDescription
pathstringYesPath to the file
makePublicbooleanNoMake file public
makePrivatebooleanNoMake file private
contentTypestringNoNew MIME type
metadataobjectNoCustom metadata key-value

Example:

javascript
modify({  path: 'reports/doc.pdf',  makePublic: true,  metadata: { author: 'claude' },});

delete_file

Delete a file from the remote filesystem.

Parameters:

ParameterTypeRequiredDescription
pathstringYesPath to the file

Example:

javascript
delete_file({  path: 'temp/old-file.txt',});

Toolset Groups

The server supports permission-based access control via tool groups:

  • readonly: Only download and list_files tools are available
  • readwrite: All tools are available (includes readonly tools)

Set ENABLED_TOOLGROUPS=readonly to restrict to read-only operations.

Authentication

The server supports multiple authentication methods:

1. Inline Credentials (Recommended)

bash
[email protected]GCS_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"

2. Key File

bash
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

3. Application Default Credentials (ADC)

bash
gcloud auth application-default login

License

MIT

來源：experimental/remote-filesystem/README.md，提交 0ed34de

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.5最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分