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

MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang #1

New issue
Closed
opened 2026-07-17 09:03:10 +02:00 by frank · 1 comment
frank commented 2026-07-17 09:03:10 +02:00
Owner
Copy link

Ziel

Ein lauffähiges Go-MVP mit zwei Betriebsmodi:

  • MCP-Server: stellt Webrequest-Tools über MCP bereit und lauscht standardmäßig auf Port 9334.
  • Private Proxy: baut von einem privaten Netz aus eine authentisierte Reverse-Verbindung zum Connector-Port 9335 des MCP-Servers auf.
  • Der MCP-Server leitet Tool-Aufrufe über diese Verbindung an den Private Proxy; dort wird der eigentliche HTTP-Request ausgeführt und das Ergebnis zurückgegeben.

Technische Leitplanken

  • Go mit klar getrennten Paketen für CLI, MCP, Connector-Protokoll, Tunnel und HTTP-Ausführung.
  • CLI mit SPF13/Cobra und Konfiguration mit SPF13/Viper.
  • Offizielles Tier-1 Go SDK: https://github.com/modelcontextprotocol/go-sdk
  • Ziel-Spezifikation für das MVP: MCP 2025-11-25. Der 2026-07-28 Release Candidate ist vor Finalisierung keine MVP-Abhängigkeit.
  • MCP-Transport: Streamable HTTP auf einem einzelnen MCP-Endpunkt.
  • Reverse Connector: HTTP/1.1 Upgrade mit Shared-Key-Authentisierung und anschließendem versioniertem, bidirektionalem Protokoll.
  • Sichere Defaults, begrenzte Ressourcen, strukturierte Logs und Graceful Shutdown.

Basisumfang

  1. Projekt- und CLI-Grundgerüst
  2. Konfigurationsmodell
  3. Spezifikation des Connector-/Tunnel-Protokolls
  4. MCP Streamable-HTTP-Server
  5. Authentisierter HTTP/1.1-Upgrade-Handshake
  6. Bidirektionales Request-Multiplexing und Verbindungslebenszyklus
  7. Private-Proxy-Modus mit Reconnect
  8. Begrenzte HTTP-Ausführungsengine
  9. MCP-Webrequest-Tools
  10. Netzwerk- und SSRF-Sicherheitsrichtlinien
  11. Observability, Health und Graceful Shutdown
  12. Automatisierte Tests und Forgejo Actions
  13. Wiki-Dokumentation und Betriebsanleitung

Definition of Done

  • Alle untergeordneten Basis-Issues sind umgesetzt und geschlossen.
  • Ein MCP-Client kann einen Webrequest auslösen, der nachweislich am privaten Proxy ausgeführt wird.
  • Verbindungsabbruch, Timeout, ungültige Authentisierung und zu große Antworten werden kontrolliert behandelt.
  • Default-Ports 9334 und 9335 funktionieren und sind über Flags, Environment und Konfigurationsdatei überschreibbar.
  • Architektur und Bedienung sind im Projekt-Wiki dokumentiert.

Referenzen

## Ziel Ein lauffähiges Go-MVP mit zwei Betriebsmodi: - MCP-Server: stellt Webrequest-Tools über MCP bereit und lauscht standardmäßig auf Port 9334. - Private Proxy: baut von einem privaten Netz aus eine authentisierte Reverse-Verbindung zum Connector-Port 9335 des MCP-Servers auf. - Der MCP-Server leitet Tool-Aufrufe über diese Verbindung an den Private Proxy; dort wird der eigentliche HTTP-Request ausgeführt und das Ergebnis zurückgegeben. ## Technische Leitplanken - Go mit klar getrennten Paketen für CLI, MCP, Connector-Protokoll, Tunnel und HTTP-Ausführung. - CLI mit SPF13/Cobra und Konfiguration mit SPF13/Viper. - Offizielles Tier-1 Go SDK: https://github.com/modelcontextprotocol/go-sdk - Ziel-Spezifikation für das MVP: MCP 2025-11-25. Der 2026-07-28 Release Candidate ist vor Finalisierung keine MVP-Abhängigkeit. - MCP-Transport: Streamable HTTP auf einem einzelnen MCP-Endpunkt. - Reverse Connector: HTTP/1.1 Upgrade mit Shared-Key-Authentisierung und anschließendem versioniertem, bidirektionalem Protokoll. - Sichere Defaults, begrenzte Ressourcen, strukturierte Logs und Graceful Shutdown. ## Basisumfang 1. Projekt- und CLI-Grundgerüst 2. Konfigurationsmodell 3. Spezifikation des Connector-/Tunnel-Protokolls 4. MCP Streamable-HTTP-Server 5. Authentisierter HTTP/1.1-Upgrade-Handshake 6. Bidirektionales Request-Multiplexing und Verbindungslebenszyklus 7. Private-Proxy-Modus mit Reconnect 8. Begrenzte HTTP-Ausführungsengine 9. MCP-Webrequest-Tools 10. Netzwerk- und SSRF-Sicherheitsrichtlinien 11. Observability, Health und Graceful Shutdown 12. Automatisierte Tests und Forgejo Actions 13. Wiki-Dokumentation und Betriebsanleitung ## Definition of Done - Alle untergeordneten Basis-Issues sind umgesetzt und geschlossen. - Ein MCP-Client kann einen Webrequest auslösen, der nachweislich am privaten Proxy ausgeführt wird. - Verbindungsabbruch, Timeout, ungültige Authentisierung und zu große Antworten werden kontrolliert behandelt. - Default-Ports 9334 und 9335 funktionieren und sind über Flags, Environment und Konfigurationsdatei überschreibbar. - Architektur und Bedienung sind im Projekt-Wiki dokumentiert. ## Referenzen - MCP SDKs/Tiers: https://modelcontextprotocol.io/docs/sdk - MCP-Versionierung: https://modelcontextprotocol.io/docs/learn/versioning - MCP Transport 2025-11-25: https://modelcontextprotocol.io/specification/2025-11-25/basic/transports - Offizielles Go SDK: https://github.com/modelcontextprotocol/go-sdk - Cobra: https://github.com/spf13/cobra - Viper: https://github.com/spf13/viper - HTTP Upgrade, RFC 9110: https://www.rfc-editor.org/rfc/rfc9110.html
frank commented 2026-07-17 16:49:22 +02:00
Author
Owner
Copy link

🤖 forge agent started

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

MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang — Ein lauffähiges Go-MVP mit zwei Betriebsmodi:

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang — Ein lauffähiges Go-MVP mit zwei Betriebsmodi:
frank 2026-07-17 16:58:09 +02:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
agent/issue-39-websuche-capability-web-search-über-duc
agent/issue-14-architektur-konfiguration-und-betrieb-im
agent/issue-13-teststrategie-und-forgejo-actions-ci-auf
agent/issue-22-yt-dlp-medien-und-youtube-transcript-too
v1.2.0
v1.1.2
v1.1.1
v1.1.0
v1.0.0
Labels
Clear labels   
agent:done
Managed by forge agent

  
agent:ready
Managed by forge agent

  
agent:working
Managed by forge agent

  
area/browser
Browser-Automation und Browser-Sessions

  
area/cli
CLI und Konfiguration

  
area/http
HTTP-Request-Ausführung und Antwortverarbeitung

  
area/mcp
Model Context Protocol und MCP-Endpunkt

  
area/media
Medien-Downloads und Transkripte

  
area/observability
Logging und Health und Lifecycle

  
area/proxy
Private-Proxy-Prozess und Verbindung

  
area/security
Authentisierung und Sicherheitsrichtlinien

  
area/testing
Tests und Fuzzing und CI

  
area/tunnel
Reverse Connector und Tunnelprotokoll

  
priority/P0
MVP-kritisch oder blockiert den Kernpfad

  
priority/P1
Wichtig für ein belastbares MVP

  
priority/P2
Nachgelagertes Folgefeature

  
type/chore
Engineering und Wartungsaufgabe

  
type/design
Architektur- oder Protokollentscheidung vor Implementierung

  
type/docs
Dokumentation und Wiki

  
type/epic
Übergeordnetes Sammel- oder Lieferumfangs-Issue

  
type/feature
Neue oder erweiterte Produktfunktion

No labels
agent:done
agent:ready
agent:working
area/browser
area/cli
area/http
area/mcp
area/media
area/observability
area/proxy
area/security
area/testing
area/tunnel
priority/P0
priority/P1
priority/P2
type/chore
type/design
type/docs
type/epic
type/feature
Milestone
Clear milestone
No items
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
codex
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Depends on
#2 Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen
ai-tools/private-proxy-mcp
#3 Connector- und Tunnelprotokoll v1 spezifizieren
ai-tools/private-proxy-mcp
#4 MCP Streamable-HTTP-Server auf Port 9334 implementieren
ai-tools/private-proxy-mcp
#9 MCP-Tools http_get und http_request bereitstellen
ai-tools/private-proxy-mcp
#8 Begrenzte HTTP-Ausführungsengine im privaten Proxy implementieren
ai-tools/private-proxy-mcp
#5 Reverse-Connector-Listener mit Shared-Key-Upgrade auf Port 9335 implementieren
ai-tools/private-proxy-mcp
#6 Tunnel-Framing, Multiplexing und Request-Lifecycle implementieren
ai-tools/private-proxy-mcp
#7 Private-Proxy-Modus mit Reconnect und Verbindungsübernahme implementieren
ai-tools/private-proxy-mcp
#11 Authentisierung und sichere Exposition des MCP-Endpunkts festlegen
ai-tools/private-proxy-mcp
#14 Architektur, Konfiguration und Betrieb im Projekt-Wiki dokumentieren
ai-tools/private-proxy-mcp
#10 Netzwerk-Policy und SSRF-Schutz für Webrequests umsetzen
ai-tools/private-proxy-mcp
#13 Teststrategie und Forgejo-Actions-CI aufsetzen
ai-tools/private-proxy-mcp
#12 Observability, Health Checks und Graceful Shutdown implementieren
ai-tools/private-proxy-mcp
Reference
ai-tools/private-proxy-mcp#1
No description provided.