Plugins Adapter

An Envoy external processor (ext-proc) for configuring and invoking guardrails in an Envoy-based gateway like MCP Gateway.

Quick Install

Prerequisites

• kubectl configured in CLI

Full Dev Build

1. Build Protocol Buffers

   python3 -m venv .venv
   source .venv/bin/activate
   ./proto-build.sh

2. Verify src/ contains: /envoy, /validate, /xds, /udpa

3. Deploy to kind cluster

   make all

See detailed build instructions for manual build steps.

Configure Plugins

Update resources/config/config.yaml with list of plugins:

plugins:
  - name: my_plugin
    path: ./plugins/my_plugin
    enabled: true

Note: See plugins/examples for example plugins.

Then deploy:

make all

Detailed Documentation

• Build Instructions - Detailed protobuf build steps
• Deployment Guide - Deployment and debugging
• Architecture - System design and diagrams