Remote Filesystem

com.pulsemcpPublished by pulsemcp.comv0.1.5Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyCloud & InfrastructureFiles & Storage

Overview

AI-generated overview

A local MCP server that lets an assistant upload, download, list, modify and delete files in a Google Cloud Storage bucket.

What you can do
Upload files from a local path or base64 data to a bucket path, optionally making them public or setting a content type and metadata. Download files as text or base64 for binary data. List files and directories with prefix filtering and a result limit. Change file properties such as public/private access, content type and custom metadata, and generate signed URLs for private files. Delete files from the bucket.
When to use it
Useful when an assistant needs to read or write files in a Google Cloud Storage bucket, for example storing screenshots, reports or generated artifacts, or retrieving existing objects, without a separate upload step. Read-only mode suits assistants that should only inspect and fetch files.
Requirements
Runs locally via npx with Node.js. Requires a Google Cloud Storage bucket name in GCS_BUCKET and one authentication method: inline service account credentials (GCS_CLIENT_EMAIL and GCS_PRIVATE_KEY), a key file path in GOOGLE_APPLICATION_CREDENTIALS, or Application Default Credentials. Optional settings include GCS_PROJECT_ID, GCS_ROOT_PATH, GCS_MAKE_PUBLIC and ENABLED_TOOLGROUPS.
Before you install
Needs a Google Cloud service account private key, supplied through GCS_PRIVATE_KEY or a key file, so treat it as a sensitive secret. The server can upload, modify and delete objects in the bucket; restrict it with ENABLED_TOOLGROUPS=readonly and GCS_ROOT_PATH where possible. Uploads or modifications can make files publicly accessible, and deleted files may be unrecoverable.

Installation

In SourceWeft

  1. Open Remote Filesystem in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: experimental/remote-filesystem/README.md at commit 0ed34de

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.5LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts