ai-tools/private-proxy-mcp

Watch

Fork 0

Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen #2

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

Ein idiomatisches Go-Projekt mit einem Binary und zwei klaren Betriebsmodi als Cobra-Subcommands.

Scope

Go-Modul und Paketstruktur anlegen.
Root-Command mit SPF13/Cobra.
Subcommands:
- mcp-server
- private-proxy
- version
SPF13/Viper als zentrale, explizit instanziierte Konfiguration verwenden; keine globale Viper-Instanz in Fachpaketen.
Konfigurationsquellen in dieser Priorität: Flags vor Environment vor Konfigurationsdatei vor Defaults.
Config-Datei über --config explizit auswählbar; ein fehlender expliziter Pfad ist ein Fehler, eine nicht vorhandene optionale Default-Datei nicht.
Environment-Präfix PRIVATE_PROXY_MCP und Mapping verschachtelter Keys auf SCREAMING_SNAKE_CASE.
Sichere Secret-Eingabe: Shared Keys nie in Logs oder Fehlertexten ausgeben.
Default-Adressen:
- MCP: 127.0.0.1:9334
- Reverse Connector Listener: 0.0.0.0:9335
Alle Adressen und Ports über Flag, Environment und Datei überschreibbar.
--help zeigt effektive Defaults; version gibt Build-Version, Commit und Build-Zeit aus.
main bleibt dünn; Cobra-Commands geben Fehler über RunE zurück.

Akzeptanzkriterien

go test ./... läuft erfolgreich.
Beide Subcommands starten mit Default-Konfiguration und reagieren sauber auf SIGINT/SIGTERM.
Unit-Tests belegen Viper-Priorität und die Defaults 9334/9335.
Ungültige Ports, Adressen, Dauerwerte oder fehlende Pflicht-Secrets werden vor dem Serverstart mit verständlicher Meldung abgelehnt.
Beispielkonfiguration ohne echte Secrets liegt im Repository.
Secret-Werte erscheinen weder in --help noch in Logs.

Referenzen

Cobra User Guide: https://github.com/spf13/cobra/blob/main/site/content/user_guide.md
Viper README und Priorität: https://github.com/spf13/viper
Viper unterstützt pflag/Cobra-Bindings: https://pkg.go.dev/github.com/spf13/viper

Teil von #1. ## Ziel Ein idiomatisches Go-Projekt mit einem Binary und zwei klaren Betriebsmodi als Cobra-Subcommands. ## Scope - Go-Modul und Paketstruktur anlegen. - Root-Command mit SPF13/Cobra. - Subcommands: - mcp-server - private-proxy - version - SPF13/Viper als zentrale, explizit instanziierte Konfiguration verwenden; keine globale Viper-Instanz in Fachpaketen. - Konfigurationsquellen in dieser Priorität: Flags vor Environment vor Konfigurationsdatei vor Defaults. - Config-Datei über --config explizit auswählbar; ein fehlender expliziter Pfad ist ein Fehler, eine nicht vorhandene optionale Default-Datei nicht. - Environment-Präfix PRIVATE_PROXY_MCP und Mapping verschachtelter Keys auf SCREAMING_SNAKE_CASE. - Sichere Secret-Eingabe: Shared Keys nie in Logs oder Fehlertexten ausgeben. - Default-Adressen: - MCP: 127.0.0.1:9334 - Reverse Connector Listener: 0.0.0.0:9335 - Alle Adressen und Ports über Flag, Environment und Datei überschreibbar. - --help zeigt effektive Defaults; version gibt Build-Version, Commit und Build-Zeit aus. - main bleibt dünn; Cobra-Commands geben Fehler über RunE zurück. ## Akzeptanzkriterien - go test ./... läuft erfolgreich. - Beide Subcommands starten mit Default-Konfiguration und reagieren sauber auf SIGINT/SIGTERM. - Unit-Tests belegen Viper-Priorität und die Defaults 9334/9335. - Ungültige Ports, Adressen, Dauerwerte oder fehlende Pflicht-Secrets werden vor dem Serverstart mit verständlicher Meldung abgelehnt. - Beispielkonfiguration ohne echte Secrets liegt im Repository. - Secret-Werte erscheinen weder in --help noch in Logs. ## Referenzen - Cobra User Guide: https://github.com/spf13/cobra/blob/main/site/content/user_guide.md - Viper README und Priorität: https://github.com/spf13/viper - Viper unterstützt pflag/Cobra-Bindings: https://pkg.go.dev/github.com/spf13/viper

frank added this to the v0.1.0 – Foundation milestone

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

frank added the

area/cli

priority/P0

type/feature

labels

2026-07-17 09:27:48 +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:39 +02:00

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

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:41 +02:00

#11 Authentisierung und sichere Exposition des MCP-Endpunkts festlegen

frank added a new dependency

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

#13 Teststrategie und Forgejo-Actions-CI aufsetzen

agent was assigned by frank

2026-07-17 09:36:59 +02:00

frank commented

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

Author

Owner

🤖 forge agent started

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

Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen — Teil von #1.

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen — Teil von #1.

frank added the

agent:working

label

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

~~frank referenced this issue 2026-07-17 09:37:03 +02:00~~

fix: #2 Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen #16

frank referenced this issue

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

fix: #2 Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen #16

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

2026-07-17 09:38:53 +02:00

fix: #2 Go-Projekt und Cobra/Viper-CLI grundlegend aufsetzen #16