Installation

protomcp binary

Homebrew (macOS / Linux)

brew install msilverblatt/tap/protomcp

Binary download

Download the latest release from GitHub Releases and place the binary on your PATH:

# macOS (Apple Silicon)
curl -L https://github.com/msilverblatt/protomcp/releases/latest/download/protomcp_darwin_arm64.tar.gz | tar xz
sudo mv protomcp /usr/local/bin/

# Linux (amd64)
curl -L https://github.com/msilverblatt/protomcp/releases/latest/download/protomcp_linux_amd64.tar.gz | tar xz
sudo mv protomcp /usr/local/bin/

From source

Requires Go 1.25+.

git clone https://github.com/msilverblatt/protomcp.git
cd protomcp
go build -o protomcp ./cmd/protomcp
sudo mv protomcp /usr/local/bin/

Verify

protomcp --version

---

Python SDK

Requires Python 3.10+.

pip install protomcp

Or with a virtual environment:

python -m venv .venv
source .venv/bin/activate
pip install protomcp

---

TypeScript SDK

Requires Node.js 18+.

npm install protomcp

Or with yarn / pnpm:

yarn add protomcp
pnpm add protomcp

---

Go SDK

Requires Go 1.25+.

go get github.com/msilverblatt/protomcp/sdk/go

---

Rust SDK

Requires Rust 1.70+ and protoc (protobuf compiler).

cargo add protomcp tokio --features tokio/full
cargo add serde_json

Install protoc if not already available:

# macOS
brew install protobuf

# Linux (apt)
sudo apt install -y protobuf-compiler

---

Runtime detection

protomcp detects the runtime from the file extension automatically:

Extension	Runtime
.py	python3 (or $PROTOMCP_PYTHON)
.ts	npx tsx (or $PROTOMCP_NODE)
.js	node (or $PROTOMCP_NODE)
.go	go run
.rs	cargo run --manifest-path <Cargo.toml path>

Use --runtime to override: pmcp dev tools.py --runtime python3.12