# 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. Self-hosted MCP server and gateway with file, terminal and Git tools over HTTP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, Linux, macOS, Windows
- **Repository:** https://github.com/cookyecat/starmux
- **MCP Registry name:** io.github.cookyecat/starmux
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add starmux -- npx -y starmux
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [McpMux](https://ai-powered.com/mcp/mcpmux-2): McpMux is an open-source MCP server for developer tools.
- [McpMux](https://ai-powered.com/mcp/mcpmux): McpMux is an open-source MCP server for developer tools.
- [Git MCP Server](https://ai-powered.com/mcp/git-mcp-server): Git MCP Server is an open-source MCP server for developer tools.
- [SassyMCP](https://ai-powered.com/mcp/sassymcp): SassyMCP is a free MCP server for developer tools.
- [Linux MCP](https://ai-powered.com/mcp/linux-mcp): Linux MCP is an open-source MCP server for cloud and infrastructure.
- [Allmcps Server](https://ai-powered.com/mcp/allmcps-server): Allmcps Server is a freemium MCP server for community directories.

---
Source: https://ai-powered.com/mcp/starmux-all-in-one-self-hosted-remote-mcp-server-and-gateway
