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

1

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

Install to Profile

1

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

Development Environment

1

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

Binary Downloads

Download pre-built binaries from our GitHub releases:

Linux

1
2

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

1
2

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:

1
2
3
4
5

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

1
2
3

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:

1
2
3
4

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

Verification

Verify your installation:

1

mcp-shell version

Next Steps