Skip to content
This project is part of pgEdge Labs and is under active development. APIs and features may change without notice.

Installation

This guide covers how to install the pgEdge MCP Bridge on your system.

Requirements

  • Go 1.24 or later (for building from source)
  • A supported operating system: Linux, macOS, or Windows

Download Pre-built Binaries

Pre-built binaries are available for each release on GitHub:

  1. Go to the Releases page
  2. Download the appropriate archive for your platform:
  3. pgedge-mcp-bridge_VERSION_linux_x86_64.tar.gz - Linux (AMD64)
  4. pgedge-mcp-bridge_VERSION_linux_arm64.tar.gz - Linux (ARM64)
  5. pgedge-mcp-bridge_VERSION_darwin_x86_64.tar.gz - macOS (Intel)
  6. pgedge-mcp-bridge_VERSION_darwin_arm64.tar.gz - macOS (Apple Silicon)

  7. pgedge-mcp-bridge_VERSION_windows_x86_64.zip - Windows (AMD64)

  8. Extract the archive:

# Linux/macOS
tar -xzf pgedge-mcp-bridge_VERSION_linux_x86_64.tar.gz

# Windows (PowerShell)
Expand-Archive -Path pgedge-mcp-bridge_VERSION_windows_x86_64.zip -DestinationPath .
  1. Move the binary to a directory in your PATH:
# Linux/macOS
sudo mv mcp-bridge /usr/local/bin/

# Or for user-local installation
mv mcp-bridge ~/.local/bin/
  1. Verify the installation:
mcp-bridge --version

Build from Source

Clone the Repository

git clone https://github.com/pgEdge/pgedge-mcp-bridge.git
cd pgedge-mcp-bridge

Build with Make

The project includes a Makefile with common build targets:

# Build for your current platform
make build

# The binary will be in bin/mcp-bridge
./bin/mcp-bridge --version

Build for All Platforms

To build binaries for all supported platforms:

make build-all

This creates binaries in bin/ for: - Linux (amd64, arm64) - macOS (amd64, arm64) - Windows (amd64, arm64)

Build Manually with Go

go build -o mcp-bridge ./cmd/mcp-bridge

Install to GOPATH

go install ./cmd/mcp-bridge

Verify Installation

After installation, verify the bridge is working:

# Check version
mcp-bridge --version

# Show help
mcp-bridge --help

Configuration File Location

The bridge looks for a configuration file in the following order:

  1. Path specified with -c or --config flag
  2. /etc/pgedge/config.yaml
  3. config.yaml in the same directory as the executable

Next Steps