Installation

Requirements

• Docker ≥ 24 (recommended) or Python ≥ 3.12
• At least one MCP server for the apps you want to sync

---

Option A — Docker (recommended)

Pull and run the official image:

docker run -d \
  --name wcp \
  -p 8000:8000 \
  -v wcp_data:/data \
  -e WCP_DB_PATH=/data/sync.db \
  -e WCP_CONFIG_PATH=/data/config.json \
  ghcr.io/lucasmella-stack/wcp:latest

The API is now available at http://localhost:8000.

---

Option B — Docker Compose (with Traefik)

Clone the repo and use the provided compose file:

git clone https://github.com/lucasmella-stack/WCP.git
cd WCP
docker compose up -d

The compose file includes Traefik labels for wcp.yourdomain.com. Edit docker-compose.yml to set your domain.

---

Option C — Python (development)

git clone https://github.com/lucasmella-stack/WCP.git
cd WCP
pip install -e ".[dev]"

# Start the API server
uvicorn wcp.api.main:app --host 0.0.0.0 --port 8000 --reload

---

Dashboard

The React dashboard is a static build served separately (or by any web server):

cd dashboard
npm install
npm run dev        # dev — http://dashboard.localhost:5173
npm run build      # production build → dist/

The dashboard proxies /api and /ws to http://localhost:8000 in dev mode.

---

Verify

curl http://localhost:8000/health
# {"status":"ok","version":"0.1.0"}