Getting Started

Get Syphon installed and run your first MCP server in under five minutes.

Install the CLI

Syphon ships as a single static binary. Pick the method that matches your environment:

macOS / Linux

$ curl -fsSL https://raw.githubusercontent.com/imisbahk/syphon/main/cli/install.sh | sh

Windows (PowerShell)

$ irm https://raw.githubusercontent.com/imisbahk/syphon/main/cli/install.ps1 | iex

Build from source

$ git clone https://github.com/imisbahk/syphon
$ cd syphon/cli && cargo install --path . --force

Verify the install:

$ syphon --version
# syphon 0.2.4

Log in

Authentication uses a device-code flow — no password typed into the terminal.

$ syphon login
# → Opens browser for OAuth confirmation
# ✓ Logged in as <username>

A bearer token is saved to ~/.syphon/credentials and an ed25519 signing key is generated at ~/.syphon/keys/signing.key. The public half is registered with the registry so every package you publish is verifiably yours.

Find a package

Search the registry by keyword. Results show name, version, download count, and author.

$ syphon search github
# NAME            VERSION  DOWNLOADS  DESCRIPTION
# github-tools    1.0.0    2.4k       GitHub API: issues, PRs, commits, releases

Get full details on any package:

$ syphon info github-tools

Install a package

$ syphon install github-tools
# ✓ Resolve  github-tools@1.0.0
# ✓ Download 13.1 KB
# ✓ Verify   signature OK (author · a3f8b2c1)
# ✓ Extract  → ~/.syphon/packages/github-tools
# ✓ Link     added to Claude Code MCP config
# ✓ Installed github-tools@1.0.0

Syphon verifies the ed25519 signature before extracting. If the tarball was tampered with, install fails and nothing is written to disk.

Next steps