Installation

How to install MCP Shell on your system

Installation

MCP Shell provides multiple installation methods to suit different environments and preferences.

The easiest way to install MCP Shell is through Nix:

Run Directly

nix run github:rafa-dot-el/mcp-shell

Install to Profile

nix profile install github:rafa-dot-el/mcp-shell

Development Environment

nix develop github:rafa-dot-el/mcp-shell

Binary Downloads

Download pre-built binaries from our GitHub releases:

Linux

curl -L https://github.com/rafa-dot-el/mcp-shell/releases/latest/download/mcp-shell_linux_amd64.tar.gz | tar xz
sudo mv mcp-shell /usr/local/bin/

macOS

curl -L https://github.com/rafa-dot-el/mcp-shell/releases/latest/download/mcp-shell_darwin_amd64.tar.gz | tar xz
sudo mv mcp-shell /usr/local/bin/

Windows

Download the Windows binary from the releases page and add it to your PATH.

Container Image

Run MCP Shell in a container:

# Docker
docker run --rm -it ghcr.io/rafa-dot-el/mcp-shell:latest

# Podman
podman run --rm -it ghcr.io/rafa-dot-el/mcp-shell:latest

From Source

Build from source using Go:

git clone https://github.com/rafa-dot-el/mcp-shell.git
cd mcp-shell
go build -o mcp-shell ./cmd/mcp-shell

Or with our development environment:

git clone https://github.com/rafa-dot-el/mcp-shell.git
cd mcp-shell
nix develop
task build

Verification

Verify your installation:

mcp-shell version

Next Steps