Skip to main content
Glama
Sign In
cascade-mcp

cascade-mcp

by cheng6563
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

cascade-mcp

Zero-configuration dynamic SSH and Docker remote development Model Context Protocol (MCP) server with streaming transfer and process control.

Ported from the Pi Cascade extension into a standalone, universal MCP server.

Key Features

  • Zero Setup Remote Operations: Connect to local/remote Docker containers, SSH servers, and nested multi-layer chains (e.g. ssh:jump-host|docker:my-container) without installing Python, Node.js, or daemons on target hosts.

  • Self-contained Go Helper: Automatically probes remote Linux architecture (amd64 / arm64) and injects a standalone statically linked helper with pidfd/procfs child process control.

  • Full Remote Toolset: Read, write, edit, bash execution, directory listing, glob finding, text grepping, and bidirectional streaming file copy.

  • Adaptive Compression: Fast file copy with automatic zstd compression and streaming backpressure.

  • Universal MCP Compatibility: Seamlessly integrates with Codex, Claude Desktop, Cursor, Zed, and any MCP-compliant AI assistant via standard I/O (stdio).

Related MCP server: SSH MCP Server

Quick Start

You can run the server directly from GitHub without manual cloning or building:

npx -y github:cheng6563/cascade-mcp

MCP Client Configuration

Codex / Claude Desktop (mcpServers config)

Add to your MCP configuration file (e.g. ~/.codex/config.toml or Claude desktop claude_desktop_config.json):

{
  "mcpServers": {
    "cascade": {
      "command": "npx",
      "args": ["-y", "github:cheng6563/cascade-mcp"]
    }
  }
}

Or for Codex config.toml:

[mcp_servers.cascade]
command = "npx"
args = ["-y", "github:cheng6563/cascade-mcp"]

Available Tools

Tool

Description

cascade_target

Discover, open, close, and manage target connections (action: "list" | "open" | "close" | "handles" | "status" | "forget" | "disconnect").

cascade_remote_bash

Execute shell commands in target environments with stdout/stderr capture and cancellation.

cascade_remote_read

Read remote files with offset and line limits.

cascade_remote_write

Write content to remote files (auto-creates parent directories).

cascade_remote_edit

Apply exact, unambiguous search-and-replace text edits.

cascade_remote_ls

List directory contents with file sizes and directory indicators.

cascade_remote_find

Search files on the remote filesystem by glob pattern.

cascade_remote_grep

Search text patterns within files on the target.

cascade_remote_copy

Bidirectional streaming file upload and download with zstd compression.

cascade_remote_mount

Mount a local Windows directory onto an SSH target, or unmount it.

License

MIT License

Available Tools

9 tools
cascade_remote_bashB

Execute a shell command on an opened remote target. Returns stdout, stderr, and exit code. Supports execution timeout in seconds. Cancellation cleanly kills child process trees using pidfd/procfs.

Inputs: handle (required), command (required), timeout.

cascade_remote_copyB

Stream transfer a regular file between local machine and opened remote target. Supports zstd compression.

Inputs: handle (required), direction (required), localPath (required), remotePath (required), +1 more.

cascade_remote_editB

Apply exact text replacements to a file on an opened remote target. Requires a READY handle. Each edit must specify oldText and newText.

Inputs: path (required), edits (required), handle (required).

cascade_remote_findA

Find files matching a glob pattern on an opened remote target. Requires a READY handle.

Inputs: handle (required), pattern (required), path, limit.

cascade_remote_grepB

Search text content within files on an opened remote target. Requires a READY handle.

Inputs: handle (required), pattern (required), glob, path, +4 more.

cascade_remote_lsB

List directory entries on an opened remote target. Returns item names, types (DIR/FILE), and sizes.

Inputs: handle (required), path, limit.

cascade_remote_readB

Read a file from an opened remote target. Requires a READY handle returned by cascade_target open. Supports offset & limit with line numbers.

Inputs: path (required), handle (required), limit, offset.

cascade_remote_writeA

Write content to a file on an opened remote target. Requires a READY handle. Automatically creates parent directories.

Inputs: path (required), handle (required), content (required).

cascade_targetA

Discover, connect, and manage Docker and SSH targets without manual agent setup. Use action=list to inspect running Docker containers. Use action=open to establish a live connection to a container, SSH host, or nested target chain, returning a target handle. Use action=handles or action=status to inspect active connections and remembered targets. Use action=close to close a specific handle, or action=disconnect to close all handles. Use action=forget to remove a remembered pinned target.

Inputs: action (required), cwd, host, mode, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A3.7/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a distinct purpose: target lifecycle (cascade_target) versus remote file/command operations (read, write, edit, bash, ls, find, grep, copy). Descriptions clarify handle requirements and action semantics, leaving no overlapping boundaries.

    Naming Consistency5/5

    All tools follow a predictable snake_case pattern with the cascade_ prefix, using clear action suffixes. cascade_target groups target management while cascade_remote_* groups remote operations, a consistent and readable convention.

    Tool Count5/5

    Nine tools are well-scoped for remote target access and manipulation. The multi-action cascade_target consolidates lifecycle operations, avoiding unnecessary tool proliferation while each remote operation earns its place.

    Completeness4/5

    Core remote read/write/edit/bash/ls/find/grep/copy and target lifecycle actions are covered. Minor gaps exist—no explicit remote delete, move, or stat operations—but agents can work around these via bash, so the surface is largely complete.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • SSH MCP Server

      uarlouski
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to securely execute commands, transfer files, and manage port forwarding on remote servers via SSH.
      158 npm
      38
      Apache 2.0

    • fast-mcp-ssh

      klNuno
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to securely execute commands on remote hosts via SSH and SFTP, with persistent shells, file transfers, screenshots, and an audit log.
      5
      MIT

    • Remote Host MCP

      0ozzzii
      F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI-controlled administration of remote Linux hosts and containers, including bounded shell execution, persistent PTY sessions, durable jobs/tasks, hardened filesystem access, process/service control, and resumable transfers.
      -