Skip to content
MCP server

Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway

Self-hosted MCP server and gateway with file, terminal and Git tools over HTTP

Install
Pricing
Open source
Platforms
self-hosted, CLI, Linux
Runs
Remotely
Version
0.18.2
Listing updated
4 days ago

Similar MCP servers

About Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway

Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

Starmux bundles a Desktop Commander engine with more than 25 host tools, so an AI client can read and write files, search with ripgrep, apply diff edits, drive interactive shells, manage background processes and run Git. The same daemon doubles as a gateway that puts several stdio or remote HTTP MCP servers behind one /mcp endpoint, with tool aliases, argument defaults, conditional routing, field redaction, read caching and custom ESM plugins.

It starts in global read-only mode on 127.0.0.1:18893 with no authentication, and one flag switches to coding mode. A LAN or Tailscale flag exposes it across machines, and access can be locked down with per-client bearer API keys or OAuth 2.0 with PKCE. The README targets headless Linux, ARM64 boards such as NVIDIA Jetson, macOS and Windows, and says the bundled engine has upstream telemetry removed.

It installs with npm (Node.js 22.12 or newer) and is managed from the CLI, a local web dashboard or a macOS menu bar app.

Install

Run in a terminal

claude mcp add starmux -- npx -y starmux

Add to claude_desktop_config.json

{
  "mcpServers": {
    "starmux": {
      "command": "npx",
      "args": [
        "-y",
        "starmux"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "starmux": {
      "command": "npx",
      "args": [
        "-y",
        "starmux"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "starmux": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "starmux"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "starmux": {
      "command": "npx",
      "args": [
        "-y",
        "starmux"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "starmux": {
      "command": "npx",
      "args": [
        "-y",
        "starmux"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Built-in host tools
25+ tools for files, diff edits, shells, processes and Git.
Multi-MCP gateway
Combine stdio and remote HTTP servers behind a single endpoint.
Read-only by default
Start in read-only mode, then switch to coding mode with one flag.
Middleware options
Tool aliases, field redaction, read caching and ESM plugins.
Access control
Per-client bearer API keys or OAuth 2.0 with PKCE.
Remote access modes
Localhost, LAN or Tailscale, SSH forwarding or a tunnel.

Good for

  • Let a cloud chat assistant work on a headless Linux server
  • Code remotely on an ARM64 board from a laptop
  • Aggregate several MCP servers behind one URL
  • Run an agent against a project in read-only mode first

Pricing

Open source

MIT-licensed, installed with npm

Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway FAQ

What is the default security posture?

Read-only mode, listening on localhost only with no authentication; coding mode and LAN access are opt-in.

What does it need?

Node.js 22.12 or newer on macOS, Linux (x64 or ARM64) or Windows.

Does it send telemetry?

The README says it is self-hosted with zero telemetry and no third-party relay.

How is it licensed?

The README describes it as MIT.

Is Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway free?

Yes. Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway is open source, so you can use and self-host it for free.

How do I add Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway to Claude Code?

Run this command in your terminal: claude mcp add starmux -- npx -y starmux

What are the best alternatives to Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway?

The closest alternatives to Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway are McpMux, McpMux, Git MCP Server, SassyMCP and Linux MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers