ai-tools/private-proxy-mcp
Watch
2
0
Fork
You've already forked private-proxy-mcp
 0
Code Issues 2 Pull requests 1 Projects Releases 5 Packages 2 Wiki Activity Actions
Page: Compatibility
Pages
ADR-Browser-Backend ADR-Browser-Identity-Playwright ADR-MCP-Go-SDK ADR-Rust-Proxy-Tauri ADR-Tunnel-Protocol Architecture CLI Compatibility Configuration Deployment Desktop-Proxy Development Home MVP-Acceptance Releases Security-MCP-Exposure Security-Network-Policy Shared-Key Troubleshooting
7 Compatibility
Forgeagent edited this page 2026-07-20 18:52:08 +02:00
Unescape Escape
Table of contents
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Versions- und Kompatibilitätsmatrix

Diese Matrix beschreibt den getesteten Repository-Stand. Versionsänderungen werden zusammen mit Dependency-Lock, ADRs, Tests und dieser Seite committed.

Schicht Version Status und Kompatibilität
Go Toolchain 1.26.5 Build- und CI-Version aus go.mod
offizielles MCP Go SDK v1.6.1 exakt in go.mod gepinnt
MCP Spec 2025-11-25 primäres und getestetes Protokollziel; Streamable HTTP
frühere MCP Specs 2025-06-18, 2025-03-26, 2024-11-05 vom SDK-Zweig laut offizieller Supportmatrix unterstützt; nicht eigenständig als Projektziel qualifiziert
Legacy HTTP+SSE – nicht registriert und nicht unterstützt
Tunnel HTTP Upgrade private-proxy-mcp/1 nur HTTP/1.1, Major 1
Tunnel Wire 1.1 (bevorzugt), 1.0 (Legacy) Handshake bietet 1.1, 1.0; Auswahl der höchsten gemeinsamen Minor
Tunnel Capabilities browser, media_download, youtube_transcript, web_search optionale, dynamisch angekündigte v1-Tokens
Wire-1.1-Erweiterungen tools_announce (0x80), progress (0x81) optional; Deadline-Horizont 30 min

Kompatibilitätsregeln

  • MCP und Tunnel werden unabhängig versioniert. Das MCP-Protokoll endet am öffentlichen Server; der interne Tunnel ist kein MCP-Transport.
  • Der MCP-Client handelt die Revision über initialize aus und sendet danach den passenden MCP-Protocol-Version-Header. Die Anwendung testet und dokumentiert primär 2025-11-25.
  • Tunnel v1 akzeptiert Upgrade-Major 1 und Wire 1.1 bzw. Legacy 1.0. Unbekannte kritische Frame-Typen 0x08–0x7f beenden die Verbindung; optionale Typen 0x80–0xff dürfen nach vollständiger Validierung übersprungen werden.
  • Bei Wire 1.1 kündigt der Proxy nach dem Upgrade Tool-Schemas per tools_announce an; Media-Jobs dürfen progress senden. Wire 1.0 nutzt weiterhin nur Capability-Tokens und einen 120-Sekunden-Deadline-Horizont.
  • Server und privater Proxy handeln eine gemeinsame Minor aus. Bei fehlender Schnittmenge antwortet der Connector mit 426.
  • Capability-Tokens sind additive Verfügbarkeitsanzeigen, keine Protokollversionsaushandlung. Unbekannte Tokens werden ignoriert.

Upgrade-Checkliste

  1. offizielle SDK-Supportmatrix und MCP-Transport-/Security-Änderungen prüfen;
  2. go.mod/go.sum aktualisieren und alle Unit-/E2E-/Race-Tests ausführen;
  3. Origin-, DNS-Rebinding-, Header- und Sessionverhalten erneut validieren;
  4. bei Wire-Änderungen Spezifikation, Golden-Vektoren, Fuzz-Seeds und beide Tunnelimplementierungen (Go und Rust) gemeinsam aktualisieren;
  5. ADR, Matrix, CLI-/Config-Seiten und Release Notes im selben PR anpassen.

Quellen: offizielle MCP-Spezifikation, offizielle Go-SDK-Supportmatrix.