Installation

Clone the Repository

git clone https://github.com/catesandrew/mcp-agent-bridge.git
cd mcp-agent-bridge

Install Dependencies

bun install

Build

TypeScript Compilation

bun run build

This compiles TypeScript source to dist/ as ES modules.

Standalone Binaries

bun run build:exe

Produces self-contained executables in exe/ using Bun's --compile flag. These binaries have zero runtime dependencies -- no Node.js or Bun needed to run them.

Install Binaries

macOS / Linux

The included installer script handles everything:

# Build and install binaries to ~/.local/bin
./install.sh

# Also set up macOS LaunchAgents
./install.sh --launchd

# Set up LaunchAgents and start them immediately
./install.sh --launchd --load

Custom Install Prefix

./install.sh --prefix /usr/local

Windows

# Build and install binaries
.\examples\windows\install.ps1

# Custom install location
.\examples\windows\install.ps1 -Prefix "C:\tools"

# Install as HTTP background services
.\examples\windows\install.ps1 -HttpService

See Windows Deployment for full details.

Verify

After installation, verify the binaries are accessible:

which claude-mcp-server    # Should show ~/.local/bin/claude-mcp-server
which codex-mcp-server
which copilot-mcp-server

Pre-built Binaries

Pre-built binaries for all platforms are available from GitHub Releases. Download the appropriate binary for your platform and place it on your PATH.

Platform	Binary
macOS ARM64 (Apple Silicon)	claude-mcp-server-darwin-arm64
macOS x64 (Intel)	claude-mcp-server-darwin-x64
Linux x64	claude-mcp-server-linux-x64
Linux ARM64	claude-mcp-server-linux-arm64
Windows x64	claude-mcp-server-windows-x64.exe