ai-tools/private-proxy-mcp

Watch

Fork 0

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

New issue

Closed

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

frank commented

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

Owner

Teil von #1. Wird während der Implementierung fortlaufend aktualisiert.

Ziel

Architektur, Sicherheitsmodell und Bedienung sind im Forgejo-Projekt-Wiki nachvollziehbar und entsprechen dem tatsächlichen Stand der Software.

Scope

Wiki-Seiten mindestens für:

Überblick und Datenfluss MCP-Client -> MCP-Server:9334 -> Reverse Connector:9335 -> Private Proxy -> Ziel.
Komponenten- und Paketarchitektur.
ADR für offizielles modelcontextprotocol/go-sdk und MCP 2025-11-25.
ADR und bytegenaue Spezifikation des HTTP/1.1-Upgrade-/Tunnelprotokolls.
CLI-Referenz für mcp-server und private-proxy.
Vollständige Konfigurationsreferenz mit Defaults, Flags, Environment und Datei-Keys.
Installation, TLS und Beispiel-Deployments.
Shared-Key-Erzeugung, Speicherung und Rotation.
MCP-Origin-, Authentisierungs- und Exposure-Modell.
SSRF-/Netzwerk-Policy samt Opt-in für interne Ziele.
Troubleshooting für Auth, Reconnect, Timeouts, Truncation und fehlenden Proxy.
Entwicklungsanleitung, Tests, Race Detector, Fuzzing und CI.
Versions-/Kompatibilitätsmatrix für MCP SDK, MCP Spec und Tunnelprotokoll.

Akzeptanzkriterien

Alle Seiten sind über eine Wiki-Startseite verlinkt.
Befehle und Konfigurationsbeispiele wurden gegen das gebaute Binary geprüft.
Keine echten Secrets, privaten Hostnamen oder internen IPs stehen in Beispielen.
Default-Ports 9334 und 9335 sind konsistent dokumentiert.
Architekturdiagramm zeigt Vertrauensgrenzen und wo Webrequests tatsächlich ausgeführt werden.
Jedes relevante Implementierungs-Issue aktualisiert die zugehörige Wiki-Seite vor Abschluss.

Referenzen

Offizielle MCP Dokumentation: https://modelcontextprotocol.io/
Offizielles Go SDK: https://github.com/modelcontextprotocol/go-sdk

Teil von #1. Wird während der Implementierung fortlaufend aktualisiert. ## Ziel Architektur, Sicherheitsmodell und Bedienung sind im Forgejo-Projekt-Wiki nachvollziehbar und entsprechen dem tatsächlichen Stand der Software. ## Scope Wiki-Seiten mindestens für: - Überblick und Datenfluss MCP-Client -> MCP-Server:9334 -> Reverse Connector:9335 -> Private Proxy -> Ziel. - Komponenten- und Paketarchitektur. - ADR für offizielles modelcontextprotocol/go-sdk und MCP 2025-11-25. - ADR und bytegenaue Spezifikation des HTTP/1.1-Upgrade-/Tunnelprotokolls. - CLI-Referenz für mcp-server und private-proxy. - Vollständige Konfigurationsreferenz mit Defaults, Flags, Environment und Datei-Keys. - Installation, TLS und Beispiel-Deployments. - Shared-Key-Erzeugung, Speicherung und Rotation. - MCP-Origin-, Authentisierungs- und Exposure-Modell. - SSRF-/Netzwerk-Policy samt Opt-in für interne Ziele. - Troubleshooting für Auth, Reconnect, Timeouts, Truncation und fehlenden Proxy. - Entwicklungsanleitung, Tests, Race Detector, Fuzzing und CI. - Versions-/Kompatibilitätsmatrix für MCP SDK, MCP Spec und Tunnelprotokoll. ## Akzeptanzkriterien - Alle Seiten sind über eine Wiki-Startseite verlinkt. - Befehle und Konfigurationsbeispiele wurden gegen das gebaute Binary geprüft. - Keine echten Secrets, privaten Hostnamen oder internen IPs stehen in Beispielen. - Default-Ports 9334 und 9335 sind konsistent dokumentiert. - Architekturdiagramm zeigt Vertrauensgrenzen und wo Webrequests tatsächlich ausgeführt werden. - Jedes relevante Implementierungs-Issue aktualisiert die zugehörige Wiki-Seite vor Abschluss. ## Referenzen - Offizielle MCP Dokumentation: https://modelcontextprotocol.io/ - Offizielles Go SDK: https://github.com/modelcontextprotocol/go-sdk

frank added this to the v0.3.0 – MCP MVP milestone

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

frank added the

priority/P0

type/docs

labels

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

frank added a new dependency

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

#1 MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang

frank added a new dependency

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

#3 Connector- und Tunnelprotokoll v1 spezifizieren

frank added a new dependency

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

#4 MCP Streamable-HTTP-Server auf Port 9334 implementieren

frank added a new dependency

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

#7 Private-Proxy-Modus mit Reconnect und Verbindungsübernahme implementieren

frank added a new dependency

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

#9 MCP-Tools http_get und http_request bereitstellen

frank added a new dependency

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

#10 Netzwerk-Policy und SSRF-Schutz für Webrequests umsetzen

frank added a new dependency

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

#11 Authentisierung und sichere Exposition des MCP-Endpunkts festlegen

frank added a new dependency

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

#12 Observability, Health Checks und Graceful Shutdown implementieren

frank added a new dependency

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

#13 Teststrategie und Forgejo-Actions-CI aufsetzen

codex was assigned by frank

2026-07-17 10:41:56 +02:00

frank commented

2026-07-17 16:18:05 +02:00

Author

Owner

🤖 forge agent started

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

Architektur, Konfiguration und Betrieb im Projekt-Wiki dokumentieren — Teil von #1. Wird während der Implementierung fortlaufend aktualisiert.

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` Architektur, Konfiguration und Betrieb im Projekt-Wiki dokumentieren — Teil von #1. Wird während der Implementierung fortlaufend aktualisiert.

frank added the

agent:working

label

2026-07-17 16:18:12 +02:00

~~frank referenced this issue 2026-07-17 16:18:31 +02:00~~

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

frank referenced this issue

2026-07-17 16:18:33 +02:00

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

frank referenced this issue

2026-07-17 16:29:20 +02:00

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