Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway
Self-hosted MCP server and gateway with file, terminal and Git tools over HTTP
- 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 starmuxAdd to claude_desktop_config.json
{
"mcpServers": {
"starmux": {
"command": "npx",
"args": [
"-y",
"starmux"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"starmux": {
"command": "npx",
"args": [
"-y",
"starmux"
]
}
}
}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.