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

MCP-Tools http_get und http_request bereitstellen #9

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

Teil von #1. Blockiert durch MCP-Server, Tunnel und HTTP-Ausführungsengine.

Ziel

MCP-Clients können sichere Lesezugriffe und allgemeine HTTP-Requests über den verbundenen privaten Proxy auslösen.

Scope

  • Tool http_get für GET/HEAD mit readOnlyHint=true.
  • Tool http_request für konfiguriert erlaubte Methoden; wegen möglicher Seiteneffekte nicht als read-only annotieren.
  • Aussagekräftige Tool-Namen, Titel und Beschreibungen.
  • JSON Schema 2020-12 mit additionalProperties=false.
  • Eingabe mindestens:
    • url
    • method beim allgemeinen Tool
    • headers als String-Multimap
    • optionaler Text- oder Base64-Body
    • optionales Timeout innerhalb konfigurierter Grenzen
  • Strukturierte Ausgabe mindestens:
    • status
    • status_text
    • final_url
    • headers
    • body
    • body_encoding
    • content_type
    • truncated
    • duration_ms
  • structuredContent gemäß outputSchema; für Abwärtskompatibilität zusätzlich kompakter TextContent.
  • Eingabe-/Policy-/HTTP-Ausführungsfehler als Tool Execution Error mit handlungsfähiger Meldung; echte Protokollfehler nur für malformed/unknown calls.
  • Kein Proxy verfügbar ergibt einen klaren, retrybaren Toolfehler.
  • Sensitive Request-/Response-Header in Fehlermeldungen und Logs redigieren.

Akzeptanzkriterien

  • tools/list liefert beide Tools mit validen Input-/Output-Schemas und korrekten Annotations.
  • Erfolgs-, 4xx-/5xx-, Timeout-, Truncation-, Policy- und Disconnect-Fälle sind getestet.
  • Eingabevalidierung erlaubt dem Modell eine gezielte Korrektur.
  • Ein End-to-End-Test ruft einen lokalen Zielserver über MCP -> Tunnel -> Private Proxy auf.
  • Tool-Namen und Schemas folgen der aktuellen stabilen MCP-Spezifikation.

Referenzen

Teil von #1. Blockiert durch MCP-Server, Tunnel und HTTP-Ausführungsengine. ## Ziel MCP-Clients können sichere Lesezugriffe und allgemeine HTTP-Requests über den verbundenen privaten Proxy auslösen. ## Scope - Tool http_get für GET/HEAD mit readOnlyHint=true. - Tool http_request für konfiguriert erlaubte Methoden; wegen möglicher Seiteneffekte nicht als read-only annotieren. - Aussagekräftige Tool-Namen, Titel und Beschreibungen. - JSON Schema 2020-12 mit additionalProperties=false. - Eingabe mindestens: - url - method beim allgemeinen Tool - headers als String-Multimap - optionaler Text- oder Base64-Body - optionales Timeout innerhalb konfigurierter Grenzen - Strukturierte Ausgabe mindestens: - status - status_text - final_url - headers - body - body_encoding - content_type - truncated - duration_ms - structuredContent gemäß outputSchema; für Abwärtskompatibilität zusätzlich kompakter TextContent. - Eingabe-/Policy-/HTTP-Ausführungsfehler als Tool Execution Error mit handlungsfähiger Meldung; echte Protokollfehler nur für malformed/unknown calls. - Kein Proxy verfügbar ergibt einen klaren, retrybaren Toolfehler. - Sensitive Request-/Response-Header in Fehlermeldungen und Logs redigieren. ## Akzeptanzkriterien - tools/list liefert beide Tools mit validen Input-/Output-Schemas und korrekten Annotations. - Erfolgs-, 4xx-/5xx-, Timeout-, Truncation-, Policy- und Disconnect-Fälle sind getestet. - Eingabevalidierung erlaubt dem Modell eine gezielte Korrektur. - Ein End-to-End-Test ruft einen lokalen Zielserver über MCP -> Tunnel -> Private Proxy auf. - Tool-Namen und Schemas folgen der aktuellen stabilen MCP-Spezifikation. ## Referenzen - MCP Tools 2025-11-25: https://modelcontextprotocol.io/specification/2025-11-25/server/tools - MCP Changelog und Tool Execution Errors: https://modelcontextprotocol.io/specification/2025-11-25/changelog - JSON Schema 2020-12 ist der MCP-Default: https://modelcontextprotocol.io/specification/2025-11-25/schema
frank commented 2026-07-17 13:36:58 +02:00
Author
Owner
Copy link

🤖 forge agent started

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

MCP-Tools http_get und http_request bereitstellen — Teil von #1. Blockiert durch MCP-Server, Tunnel und HTTP-Ausführungsengine.

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` MCP-Tools http_get und http_request bereitstellen — Teil von #1. Blockiert durch MCP-Server, Tunnel und HTTP-Ausführungsengine.
frank 2026-07-17 14:03:14 +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.

Blocks
#1 MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang
ai-tools/private-proxy-mcp
#12 Observability, Health Checks und Graceful Shutdown implementieren
ai-tools/private-proxy-mcp
#13 Teststrategie und Forgejo-Actions-CI aufsetzen
ai-tools/private-proxy-mcp
#14 Architektur, Konfiguration und Betrieb im Projekt-Wiki dokumentieren
ai-tools/private-proxy-mcp
#20 Request-Identitätsprofile pro Proxy-Aufruf auswählbar machen
ai-tools/private-proxy-mcp
Depends on
#4 MCP Streamable-HTTP-Server auf Port 9334 implementieren
ai-tools/private-proxy-mcp
#8 Begrenzte HTTP-Ausführungsengine im privaten Proxy implementieren
ai-tools/private-proxy-mcp
#10 Netzwerk-Policy und SSRF-Schutz für Webrequests umsetzen
ai-tools/private-proxy-mcp
Reference
ai-tools/private-proxy-mcp#9
No description provided.