OCP Server

Deployment infrastructure for the Open Context Protocol specification site and registry API.

Architecture

• Caddy: Reverse proxy with automatic HTTPS via Let's Encrypt
• Hugo Site: Static documentation from ocp-spec
• Registry API: FastAPI service from ocp-registry

All services run as Docker containers orchestrated by Docker Compose, using pre-built images from GitHub Container Registry.

Deployment

Automated Setup

Run the setup script on a fresh Ubuntu 22.04/24.04 VPS:

curl -fsSL https://raw.githubusercontent.com/opencontextprotocol/ocp-server/main/setup-vps.sh | bash

This installs Docker, clones the repo, and creates the .env configuration file.

Manual Deployment

# Clone repository
git clone https://github.com/opencontextprotocol/ocp-server.git
cd ocp-server

# Configure environment
cp .env.example .env
# Edit .env to set your domain

# Pull and start services
docker compose pull
docker compose up -d

# View logs
docker compose logs -f

Configuration

• docker-compose.yml: Service definitions, networking, and image references
• Caddyfile: Reverse proxy routing and automatic HTTPS configuration
• .env: Environment variables (domain name for production)

Environment Variables

Copy .env.example to .env and configure:

• DOMAIN: Your production domain (e.g., opencontextprotocol.io) or localhost for local testing

Services

• https://your-domain → Hugo documentation site
• https://your-domain/api/v1/registry → Registry API endpoints