Run — mcp-replicate-hosted Build

Session am 2026-05-19. Phase 2.1 + 2.2 aus dem Design-Stack-Plan fuer Julian umgesetzt: kompletter Code-Bau eines zweiten hosted MCP (mcp-replicate-hosted) analog mcp-vf-hosted, plus Video-Provider-Entscheidung.

Was gemacht wurde

Code

Repo angelegt: ~/source/mcps/mcp-replicate-hosted/ — vollstaendig Mirror des mcp-vf-hosted-Patterns mit einem statt vier Sub-MCPs.

Validierung lokal

uv sync --all-extras       # OK
uv run pytest -q           # 39 passed in 0.68s
uv run ruff check src/ tests/   # All checks passed!
uv run python -c "from mcp_replicate_hosted.main import build_app; print(build_app().name)"
# -> vf-replicate

Replicate-Video-Check (Phase 2.2)

Live-Check der Replicate API am 2026-05-19 18:30 CET via QUERY /v1/models. Befund:

Nicht verfuegbar: Sora 2 (OpenAI hostet selbst), Veo 3.1 (Google bevorzugt Vertex AI direkt). Beides nicht VF-blockierend.

ADR geschrieben: vf-video-gen-provider. Entscheidung: Option A (Replicate-Hosted erweitern), Video-Modelle in Whitelist + create_video Layer-Tool ergaenzt.

AWS-Vorbereitung

• ECR-Repo mcp-replicate-hosted in av-production (425924867359, eu-central-1) angelegt — aws ecr create-repository 2026-05-19 18:32 CET
• Image-Scan-on-Push aktiv, AES256 encryption
• ECR-URI: 425924867359.dkr.ecr.eu-central-1.amazonaws.com/mcp-replicate-hosted

Vault-Doku

Was offen ist (Marvin-Schritte)

Sofort (Code-Side Final)

• Commit ~/source/mcps/mcp-replicate-hosted/ (NEW repo)
• Commit Vault-Changes (Capability + ADR + Run-Log + Plan-Updates)

AWS-Deploy (~30 Min wenn alle Inputs da)

1. Replicate-API-Token besorgen + Spending-Cap

   • https://replicate.com/account/api-tokens — neuer Token “vf-hosted” anlegen
   • https://replicate.com/account/billing — Spending limit auf $100/Mo,Alertbei$50

2. AWS Secrets Manager

   aws secretsmanager create-secret \
     --name mcp-replicate-hosted/upstream-tokens \
     --secret-string '{"REPLICATE_API_TOKEN":"r8_..."}' \
     --region eu-central-1 --profile av-production

3. Cloudflare-Tunnel via Dashboard ODER mcp-cloudflare-Tool

   • Tunnel “mcp-replicate-hosted” anlegen
   • Ingress: replicate.agenticventures.de → http://localhost:8080
   • Tunnel-Token kopieren:

     aws secretsmanager create-secret \
       --name mcp-replicate-hosted/cloudflared-token \
       --secret-string '<tunnel-token>' \
       --region eu-central-1 --profile av-production

   • Tunnel-ID notieren fuer DNS-CNAME

4. Scalekit-Resource (EU-Region) ueber Marvins Scalekit-Dashboard

   • MCP → Resources → New
   • Resource-Identifier: https://replicate.agenticventures.de/mcp
   • Resource-Name: VF Replicate Image-Gen MCP
   • Resource-ID (res_...) notieren

5. Stack-Datei aktualisieren in ~/source/mcps/mcp-replicate-hosted/infra/lib/mcp-replicate-hosted-stack.ts:

   • upstreamTokens ARN-Suffix einsetzen (aus Schritt 2)
   • cloudflaredToken ARN-Suffix einsetzen (aus Schritt 3)
   • SCALEKIT_RESOURCE_ID mit res_… aus Schritt 4 ersetzen

6. Docker-Image bauen + push (linux/amd64!)

   cd ~/source/mcps
   docker buildx build --platform linux/amd64 \
     -f mcp-replicate-hosted/Dockerfile \
     -t 425924867359.dkr.ecr.eu-central-1.amazonaws.com/mcp-replicate-hosted:latest \
     --push .

7. Image-Digest holen + im Stack pinnen

   aws ecr describe-images \
     --repository-name mcp-replicate-hosted --image-ids imageTag=latest \
     --query 'imageDetails[0].imageDigest' --output text \
     --profile av-production --region eu-central-1

   Im Stack-File sha256:PLACEHOLDER_DIGEST_REPLACE_AFTER_FIRST_PUSH ersetzen.

8. CDK Deploy

   cd ~/source/mcps/mcp-replicate-hosted/infra
   npm install
   npx cdk deploy --profile av-production

9. DNS-Cutover in Cloudflare

   • CNAME replicate.agenticventures.de → <tunnel-id>.cfargotunnel.com, proxied=true

10. Smoke extern

    curl https://replicate.agenticventures.de/health

Open WebUI Tool-Whitelist

Nach Live-Schaltung:

• Admin-UI von vf-chat.agenticventures.de → Tools → Add MCP Server
• URL: https://replicate.agenticventures.de/mcp, Type: Streamable HTTP, OAuth 2.1
• OAuth-Flow als Marvin (+ Julian, Andre, Christoph wenn AVV unterschrieben) durchspielen
• vf-nova Tool-Whitelist erweitern um die 10 sichtbaren Tools (siehe Capability-File #mcp-tool-whitelist-fuer-open-webui-vf)

AVV + VF-Komm

• VF-AVV: Replicate Inc. als Subprozessor eintragen
• extern/shared/vibe-factory/avv-replicate.md schreiben (Briefing fuer Andre)
• Erst NACH AVV-Sign: Julian + Christoph zu OAuth einladen
• Julian-Live-Test organisieren: 2 Test-Prompts (Hero-Bild + Speaker-Card), Feedback einsammeln

Anti-Scope

Nicht in diesem Run gemacht (bewusst):

• AWS-Deploy (braucht Replicate-Token, Scalekit-Klick, AVV) — als Handover fuer Marvin
• fal.ai / Vertex EU Sub-Plan (Phase 2.2 Option B/C nicht gewaehlt — siehe ADR)
• Self-Host Wan 2.6 auf Hetzner (Industriekunden, separate Story)
• Skill-spezifische Custom Models (Phase 3)
• open-design Cherry-Pick beyond Anti-Slop (Phase 3)
• Brand-Kit-Discovery-Wizard

Lessons fuer naechstes Hosted-MCP-Repo

Das Mirror-Pattern hat funktioniert wie geplant. Reproduzierbare Schritte:

1. Repo-Skelett vom mcp-vf-hosted-Pattern anlegen (Verzeichnisse + pyproject)
2. ratelimit.py + audit.py 1:1 kopieren — sind generisch
3. settings.py minimal anpassen (Token-Felder + ggf. domain-spezifische Defaults)
4. config.py + brand_lock.py oder aequivalente Domain-Layer je nach Use-Case
5. main.py: GuardMiddleware um domain-spezifische Checks erweitern (hier Modell-Whitelist)
6. Layer-Tools fuer Higher-Level-Abstraktion ueber Sub-MCP-Raw-Tools
7. ToolWhitelistMiddleware mit ~10 Tools default — search_tools als Discovery
8. CDK-Stack-File mit klaren PLACEHOLDER-Markern fuer ARNs + Image-Digest + Scalekit-Resource-ID
9. Tests fuer generische Layer (audit, ratelimit, settings) + domain-spezifische (whitelist, brand-lock)

Pattern-Doku in mcp-hosting-fargate-tunnel passt unveraendert.

Cross-Refs

• Plan-Source: 2026-05-19-design-stack-julian
• Sprint: sprint-2-replicate-hosted
• Capability: mcp-replicate-hosted
• Repo: mcp-replicate-hosted
• ADR Video-Provider: vf-video-gen-provider
• Vorbild-Stack: mcp-vf-hosted
• Pattern: mcp-hosting-fargate-tunnel