ai-tools/private-proxy-mcp

Watch

Fork 0

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

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

Den öffentlichen MCP-Betriebsmodus mit dem offiziellen Go SDK und dem aktuellen stabilen MCP-Protokoll bereitstellen.

Scope

github.com/modelcontextprotocol/go-sdk/mcp verwenden; keine eigene JSON-RPC-/MCP-Implementierung.
Aktuelle stabile SDK-v1-Version pinnen und Updates kontrolliert prüfen.
Streamable HTTP auf einem einzelnen, konfigurierbaren Endpoint, standardmäßig /mcp.
Listener-Default 127.0.0.1:9334; öffentliche Bindung muss explizit konfiguriert werden.
Server-Metadaten, Version und tools-Capability korrekt melden.
MCP 2025-11-25 als MVP-Ziel; Version wird über das SDK ausgehandelt.
Origin-Prüfung ausdrücklich konfigurieren. Hintergrund: Ab Go-SDK v1.6 ist sie nicht mehr automatisch aktiv.
Ungültige Origin-, Content-Type- und Protokollversion-Anfragen mit passenden HTTP-Statuscodes ablehnen.
Sinnvolle net/http-Limits: ReadHeaderTimeout, IdleTimeout, MaxHeaderBytes und Graceful Shutdown.
Keine Nutzdaten oder Secrets ungefiltert loggen.

Akzeptanzkriterien

Ein MCP Inspector oder SDK-Testclient kann initialisieren, tools/list aufrufen und Sessions sauber beenden.
GET, POST und DELETE verhalten sich gemäß Streamable-HTTP-Spezifikation und SDK.
Default-Port ist 9334.
Ungültige Origin wird mit 403 abgelehnt.
Tests decken Initialisierung, Tools-Liste, fehlerhafte Header und Shutdown ab.
Keine Unterstützung des veralteten HTTP+SSE-Transports im MVP, sofern kein separates Kompatibilitäts-Issue beschlossen wird.

Referenzen

Offizielles Tier-1 Go SDK: https://github.com/modelcontextprotocol/go-sdk
SDK-Übersicht: https://modelcontextprotocol.io/docs/sdk
MCP Streamable HTTP: https://modelcontextprotocol.io/specification/2025-11-25/basic/transports
Go SDK Streamable HTTP API: https://pkg.go.dev/github.com/modelcontextprotocol/go-sdk/mcp
SDK v1.6 Origin-Verhalten: https://github.com/modelcontextprotocol/go-sdk/releases/tag/v1.6.0

Teil von #1. ## Ziel Den öffentlichen MCP-Betriebsmodus mit dem offiziellen Go SDK und dem aktuellen stabilen MCP-Protokoll bereitstellen. ## Scope - github.com/modelcontextprotocol/go-sdk/mcp verwenden; keine eigene JSON-RPC-/MCP-Implementierung. - Aktuelle stabile SDK-v1-Version pinnen und Updates kontrolliert prüfen. - Streamable HTTP auf einem einzelnen, konfigurierbaren Endpoint, standardmäßig /mcp. - Listener-Default 127.0.0.1:9334; öffentliche Bindung muss explizit konfiguriert werden. - Server-Metadaten, Version und tools-Capability korrekt melden. - MCP 2025-11-25 als MVP-Ziel; Version wird über das SDK ausgehandelt. - Origin-Prüfung ausdrücklich konfigurieren. Hintergrund: Ab Go-SDK v1.6 ist sie nicht mehr automatisch aktiv. - Ungültige Origin-, Content-Type- und Protokollversion-Anfragen mit passenden HTTP-Statuscodes ablehnen. - Sinnvolle net/http-Limits: ReadHeaderTimeout, IdleTimeout, MaxHeaderBytes und Graceful Shutdown. - Keine Nutzdaten oder Secrets ungefiltert loggen. ## Akzeptanzkriterien - Ein MCP Inspector oder SDK-Testclient kann initialisieren, tools/list aufrufen und Sessions sauber beenden. - GET, POST und DELETE verhalten sich gemäß Streamable-HTTP-Spezifikation und SDK. - Default-Port ist 9334. - Ungültige Origin wird mit 403 abgelehnt. - Tests decken Initialisierung, Tools-Liste, fehlerhafte Header und Shutdown ab. - Keine Unterstützung des veralteten HTTP+SSE-Transports im MVP, sofern kein separates Kompatibilitäts-Issue beschlossen wird. ## Referenzen - Offizielles Tier-1 Go SDK: https://github.com/modelcontextprotocol/go-sdk - SDK-Übersicht: https://modelcontextprotocol.io/docs/sdk - MCP Streamable HTTP: https://modelcontextprotocol.io/specification/2025-11-25/basic/transports - Go SDK Streamable HTTP API: https://pkg.go.dev/github.com/modelcontextprotocol/go-sdk/mcp - SDK v1.6 Origin-Verhalten: https://github.com/modelcontextprotocol/go-sdk/releases/tag/v1.6.0

frank added this to the v0.3.0 – MCP MVP 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:39 +02:00

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

frank added a new dependency

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

#11 Authentisierung und sichere Exposition des MCP-Endpunkts festlegen

frank added a new dependency

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

#9 MCP-Tools http_get und http_request bereitstellen

frank added a new dependency

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

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

frank added a new dependency

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

#15 Folgefeature: Standardkonforme OAuth-2.1-Autorisierung für Remote-MCP

codex was assigned by frank

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

codex was unassigned by frank

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

frank added a new dependency

2026-07-17 11:57:48 +02:00

#21 Browser Use über den privaten Reverse Proxy anbieten

frank added a new dependency

2026-07-17 11:57:49 +02:00

#22 yt-dlp-Medien- und YouTube-Transcript-Tools über den privaten Proxy bereitstellen

frank self-assigned this

2026-07-17 13:25:31 +02:00

frank commented

2026-07-17 13:25:35 +02:00

Author

Owner

🤖 forge agent started

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

MCP Streamable-HTTP-Server auf Port 9334 implementieren — Teil von #1.

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` MCP Streamable-HTTP-Server auf Port 9334 implementieren — Teil von #1.

frank added the

agent:working

label

2026-07-17 13:25:35 +02:00

~~frank referenced this issue 2026-07-17 13:25:37 +02:00~~

fix: #4 MCP Streamable-HTTP-Server auf Port 9334 implementieren #27

frank removed their assignment

2026-07-17 13:25:37 +02:00

codex was assigned by frank

2026-07-17 13:25:37 +02:00

frank referenced this issue

2026-07-17 13:25:37 +02:00