ai-tools/private-proxy-mcp

Watch

Fork 0

Connector- und Tunnelprotokoll v1 spezifizieren #3

New issue

Closed

opened 2026-07-17 09:05:48 +02:00 by frank · 1 comment

frank commented

2026-07-17 09:05:48 +02:00

Owner

Teil von #1.

Ziel

Vor der Implementierung ein kleines, testbares und erweiterbares Wire-Protokoll für die Verbindung zwischen öffentlichem MCP-Server und privatem Proxy festlegen.

Scope

HTTP/1.1-Upgrade-Handshake dokumentieren:
- eigener, stabiler Upgrade-Token, zum Beispiel private-proxy-mcp/1
- erforderliche Request-/Response-Header
- Statuscodes für Erfolg und Fehler
- Protokollversions-Aushandlung
Binäres oder längenpräfixiertes Framing nach dem 101-Response definieren.
Nachrichtentypen mindestens: request, response, error, cancel, ping, pong und goaway.
Korrelations-ID, maximale Framegröße und eindeutige Byte-Reihenfolge definieren.
Gleichzeitige Requests über eine Verbindung ermöglichen; Antworten dürfen in anderer Reihenfolge eintreffen.
Cancel-, Deadline-, Backpressure- und Verbindungsabbruch-Semantik festlegen.
Verhalten bei unbekannten Versionen, Nachrichtentypen, doppelten IDs, ungültigen Längen und unvollständigen Frames definieren.
Festhalten, dass HTTP Upgrade nur über HTTP/1.1 läuft und TLS vor dem Upgrade terminiert wird.
Architekturentscheidung im Wiki als ADR dokumentieren.

Akzeptanzkriterien

Wire-Format ist bytegenau mit Beispielen beschrieben.
Eine Zustandsmaschine für Client und Server ist dokumentiert.
Kompatibilitätsregeln für zukünftige Minor-/Major-Versionen sind festgelegt.
Es gibt Golden-Testvektoren für gültige und ungültige Frames.
Sicherheitsgrenzen und Ressourcenlimits sind Teil der Spezifikation.
Die Implementierung kann ohne weitere Protokollentscheidungen begonnen werden.

Referenzen

HTTP Upgrade in RFC 9110: https://www.rfc-editor.org/rfc/rfc9110.html#name-upgrade
Ein 101-Response darf nur auf ein vom Client angebotenes Protokoll wechseln.
Go net/http: https://pkg.go.dev/net/http

Teil von #1. ## Ziel Vor der Implementierung ein kleines, testbares und erweiterbares Wire-Protokoll für die Verbindung zwischen öffentlichem MCP-Server und privatem Proxy festlegen. ## Scope - HTTP/1.1-Upgrade-Handshake dokumentieren: - eigener, stabiler Upgrade-Token, zum Beispiel private-proxy-mcp/1 - erforderliche Request-/Response-Header - Statuscodes für Erfolg und Fehler - Protokollversions-Aushandlung - Binäres oder längenpräfixiertes Framing nach dem 101-Response definieren. - Nachrichtentypen mindestens: request, response, error, cancel, ping, pong und goaway. - Korrelations-ID, maximale Framegröße und eindeutige Byte-Reihenfolge definieren. - Gleichzeitige Requests über eine Verbindung ermöglichen; Antworten dürfen in anderer Reihenfolge eintreffen. - Cancel-, Deadline-, Backpressure- und Verbindungsabbruch-Semantik festlegen. - Verhalten bei unbekannten Versionen, Nachrichtentypen, doppelten IDs, ungültigen Längen und unvollständigen Frames definieren. - Festhalten, dass HTTP Upgrade nur über HTTP/1.1 läuft und TLS vor dem Upgrade terminiert wird. - Architekturentscheidung im Wiki als ADR dokumentieren. ## Akzeptanzkriterien - Wire-Format ist bytegenau mit Beispielen beschrieben. - Eine Zustandsmaschine für Client und Server ist dokumentiert. - Kompatibilitätsregeln für zukünftige Minor-/Major-Versionen sind festgelegt. - Es gibt Golden-Testvektoren für gültige und ungültige Frames. - Sicherheitsgrenzen und Ressourcenlimits sind Teil der Spezifikation. - Die Implementierung kann ohne weitere Protokollentscheidungen begonnen werden. ## Referenzen - HTTP Upgrade in RFC 9110: https://www.rfc-editor.org/rfc/rfc9110.html#name-upgrade - Ein 101-Response darf nur auf ein vom Client angebotenes Protokoll wechseln. - Go net/http: https://pkg.go.dev/net/http

frank added this to the v0.1.0 – Foundation milestone

2026-07-17 09:27:18 +02:00

frank added the

labels

2026-07-17 09:27:49 +02:00

frank added a new dependency

2026-07-17 09:30:37 +02:00

#1 MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang

frank added a new dependency

2026-07-17 09:30:40 +02:00

#5 Reverse-Connector-Listener mit Shared-Key-Upgrade auf Port 9335 implementieren

frank added a new dependency

2026-07-17 09:30:42 +02:00

#14 Architektur, Konfiguration und Betrieb im Projekt-Wiki dokumentieren

agent was assigned by frank

2026-07-17 09:37:46 +02:00

frank commented

2026-07-17 09:46:43 +02:00

Author

Owner

🤖 forge agent started

Agent: codex
Model: gpt-5.6-sol
Mode: pr
Trigger: assignee=agent|+5 mapped

Connector- und Tunnelprotokoll v1 spezifizieren — Teil von #1.

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` Connector- und Tunnelprotokoll v1 spezifizieren — Teil von #1.

frank added the

agent:working

label

2026-07-17 09:46:43 +02:00

~~frank referenced this issue 2026-07-17 09:46:45 +02:00~~

fix: #3 Connector- und Tunnelprotokoll v1 spezifizieren #17

frank referenced this issue

2026-07-17 09:46:45 +02:00

fix: #3 Connector- und Tunnelprotokoll v1 spezifizieren #17

frank referenced this issue from a pull request that will close it,

2026-07-17 09:51:27 +02:00

fix: #3 Connector- und Tunnelprotokoll v1 spezifizieren #17