Install

Two steps:

1. Install the binary — one curl/irm one-liner.
2. Register it in your MCP client — native-mcp register, interactive.

The installer never modifies any client config. Registration is a separate, explicit step.

1. Install the binary

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/KevinBonnoron/native-mcp/main/scripts/install.sh | sh

Windows

irm https://raw.githubusercontent.com/KevinBonnoron/native-mcp/main/scripts/install.ps1 | iex

The installer will:

1. Detect your OS and architecture and download the matching binary from the latest release.
2. Verify its SHA-256 checksum.
3. Install it to ~/.local/bin/native-mcp (Linux/macOS) or %LOCALAPPDATA%\Programs\native-mcp\native-mcp.exe (Windows). On Windows, the install dir is added to your user PATH automatically.

Installer options

Linux / macOS

# Pin a version, install system-wide
PREFIX=/usr/local/bin VERSION=v0.1.0 sh -c "$(curl -fsSL https://.../install.sh)"

# Direct invocation
./scripts/install.sh --prefix /usr/local/bin --version v0.1.0

Windows

$env:VERSION = 'v0.1.0'; $env:PREFIX = 'C:\Tools\native-mcp'
irm https://.../install.ps1 | iex

Flag (sh / ps1)	Env var	Default	Description
--prefix DIR / -Prefix	PREFIX	~/.local/bin (unix) %LOCALAPPDATA%\Programs\native-mcp (win)	Install directory
--version VER / -Version	VERSION	latest	Release tag
--repo OWNER/REPO / -Repo	REPO	KevinBonnoron/native-mcp	Source repository

2. Register in your MCP client

native-mcp register

Interactive: detects locally-installed clients (Claude Code, Claude Desktop, Cursor) and offers to register every zero-config server (time, calculator, json, crypto, encode, text, system, dns, scheduler) in all of them.

For finer control, use the scripted form. See native-mcp register for the full reference.

# One client, specific servers
native-mcp register claude-code time calculator json

# All detected clients
native-mcp register --all time

# A server that needs runtime args
native-mcp register claude-code filesystem -- /tmp /home/you/projects
native-mcp register claude-code shell      -- --allow ls,grep,find,cat

# Inspect what's registered
native-mcp register --list

# Remove
native-mcp register --remove

Other clients

native-mcp register only manages Claude Code, Claude Desktop, and Cursor — the three with the largest install base and a stable config format. For Continue, Cline, Zed, Sourcegraph Cody, etc., add the entry by hand once: it's three lines of JSON. See Use with any MCP client.

Manual download (no installer)

Pick a binary from the latest release:

Linux / macOS

os=$(uname -s | tr '[:upper:]' '[:lower:]')
arch=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
curl -fsSL "https://github.com/KevinBonnoron/native-mcp/releases/latest/download/native-mcp-${os}-${arch}" -o native-mcp
chmod +x native-mcp
sudo mv native-mcp /usr/local/bin/

Windows

$url = "https://github.com/KevinBonnoron/native-mcp/releases/latest/download/native-mcp-windows-amd64.exe"
Invoke-WebRequest -Uri $url -OutFile "$env:LOCALAPPDATA\Programs\native-mcp\native-mcp.exe"

Build from source

Requires Go ≥ 1.22.

go install github.com/KevinBonnoron/native-mcp/cmd/native-mcp@latest

Or clone and build:

git clone https://github.com/KevinBonnoron/native-mcp
cd native-mcp
go build -o native-mcp ./cmd/native-mcp

Verify

native-mcp --version
native-mcp inspect       # list of bundled servers and their tools