My Cool Proxy

My Cool Proxy ist ein Model Context Protocol (MCP) Server-Gateway, das versucht, viele wahrgenommene Probleme mit MCP zu lösen, wie es heute existiert. In keiner bestimmten Reihenfolge sind das:

• Tool-Beschreibungen blähen das Kontextfenster auf: Dies ist ein Problem damit, wie die meisten Agenten in MCP integriert sind. Anstatt Abstraktionen zu implementieren, die das Laden von Tools bei Bedarf ermöglichen, laden die meisten Anwendungen alle MCP-Tools auf einmal in den Kontext. Um dies abzumildern, kapselt My Cool Proxy Tools in einem Lua-Interpreter ein und stellt Tools höherer Ebene bereit, um Tools inkrementell zu entdecken. Weitere Informationen finden Sie unter Progressive Disclosure.

• Tool-Ergebnisse blähen das Kontextfenster auf, warum nicht Bash verwenden? Anstatt MCP-Tools zu verwenden, könnten Agenten einfach Terminalbefehle ausführen und Bash verwenden, um ihre Ergebnisse zu filtern – allerdings bedeutet dies, dass der Agent häufiger risikoreiche Aktionen ausführen darf. Beispielsweise könnte man einem Agenten erlauben, die gh-CLI zu verwenden, um mit GitHub zu interagieren, aber er kann dann auch die gh-CLI verwenden, um ändernde oder destruktive Operationen auszuführen. Mit dem GitHub MCP Server können Sie stattdessen problemlos auf reine Lese-Tools beschränken. MCP ermöglicht es Ihnen, genau zu kontrollieren, auf welche Tools Agenten Zugriff haben. Um dies zu unterstützen, erlaubt Ihnen My Cool Proxy, die Tools, die Agenten ausgesetzt werden, weiter zu filtern.

• Die meisten MCP-Funktionen werden nicht unterstützt: Leider stellen die meisten Anwendungen Agenten nur MCP-Tools zur Verfügung und vernachlässigen die anderen Client- und Server-Funktionen des Protokolls. My Cool Proxy strebt eine gemeinsame Abstraktionsschicht für möglichst viele Protokollfunktionen an, sodass Entwickler die vollständigen Fähigkeiten von MCP in jeder MCP-kompatiblen Anwendung nutzen können. Dies ist eine laufende Arbeit – siehe die Funktionsunterstützungstabelle für weitere Details.

• Das Verwalten einer Konfigurationsdatei für mehrere Agenten ist mühsam: Wenn Sie mehr als eine MCP-kompatible Anwendung verwenden, werden Sie schnell auf Herausforderungen stoßen, die MCP-Serverkonfiguration über diese hinweg synchron zu halten. My Cool Proxy löst dies, indem es als einzelner Integrationspunkt für jeden von Ihnen verwendeten Server fungiert und die Anzahl der zu synchronisierenden Server auf nur einen reduziert.

Schnellstart

0. Installation

Installieren Sie es global, um es als CLI-Tool zu verwenden:

npm install -g @karashiiro/my-cool-proxy

Oder führen Sie es direkt über npx aus:

npx @karashiiro/my-cool-proxy

1. Konfigurieren

Das Gateway erstellt beim ersten Start automatisch eine Standardkonfiguration. Führen Sie es einfach einmal aus, um die Konfigurationsdatei zu generieren:

my-cool-proxy  # Creates config and starts (with no servers)

# Find your config location
my-cool-proxy --config-path

Bearbeiten Sie dann die Konfiguration, um Ihre MCP-Server hinzuzufügen.

Beispielkonfigurationsstruktur:

{
  "port": 3000,
  "host": "localhost",
  "mcpClients": {
    "my-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Oder kopieren Sie die Beispielkonfiguration für einen vollständigeren Ausgangspunkt.

2. Ausführen

# If installed globally
my-cool-proxy

# If running via npx
npx @karashiiro/my-cool-proxy

3. Verbinden

Fügen Sie es in Ihrer MCP-Client-Konfiguration hinzu, z. B. in Claude Desktop:

{
  "mcpServers": {
    "my-cool-proxy": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

4. Verwenden

Bitten Sie Ihren Agenten, eine Aufgabe auszuführen, bei der Ihre konfigurierten MCP-Server helfen können, und beobachten Sie, wie es läuft!

Progressive Disclosure

Dieser Proxy fungiert als Gateway zwischen Agenten und mehreren MCP-Servern (Model Context Protocol). Anstatt sich einzeln mit jedem MCP-Server zu verbinden, verbinden sich Agenten mit diesem einzelnen Proxy und erhalten über eine einheitliche Schnittstelle Zugriff auf alle konfigurierten Server.

Agenten starten mit minimalem Wissen darüber, welche Server oder Tools verfügbar sind. Sie bauen den Kontext schrittweise auf:

1. Prüfen Sie die Serveranweisungen – My Cool Proxy lädt einen kleinen Prompt mit kurzen Auszügen der konfigurierten Server und Tools vor, um den Agenten auf deren Nutzung vorzubereiten.

2. Rufen Sie list-servers auf – Der Kontext des Agenten enthält jetzt Namen und Beschreibungen aller verfügbaren MCP-Server (z. B. "github", "slack", "database").

3. Rufen Sie list-server-tools(server_name) auf – Der Kontext des Agenten erweitert sich um alle Toolnamen und -beschreibungen für diesen bestimmten Server.

4. Rufen Sie tool-details(server_name, tool_name) auf – Der Kontext des Agenten enthält jetzt vollständige Parameterschemata, Rückgabetypen (falls verfügbar) und Verwendungsbeispiele für ein bestimmtes Tool.

5. Rufen Sie execute(lua_script) auf – Mit vollem Kontext kann der Agent Lua-Skripte schreiben, die die entdeckten Tools aufrufen.

Anstatt alle Tools und Toolbeschreibungen vorab in den Kontext zu laden, verschiebt dies das Laden von Tools, bis der Agent feststellt, dass diese Tools benötigt werden.

Tool-Verkettung mit Lua: Sobald ein Agent weiß, welche Tools es gibt, kann er komplexe mehrstufige Workflows in einem einzigen execute()-Aufruf zusammenstellen und spart so den Kontext-Overhead zwischenzeitlicher Tool-Ergebnisse. Die Lua-Laufzeit bietet Zugriff auf alle entdeckten Server als Globals, wobei Tools als asynchrone Funktionen aufrufbar sind.

Sequenzielle Tool-Verkettung:

local raw_data = api_server.fetch({ id = 123 }):await()
local processed = processor.transform({ input = raw_data }):await()
result(processed)

Bedingte Logik:

local status = checker.validate({}):await()
if status.ok then
  result(processor.run({}):await())
else
  result(error_handler.notify({ error = status.message }):await())
end

Iteration mit Schleifen:

local results = {}
for i = 1, 5 do
  results[i] = worker.process({ index = i }):await()
end
result({ total = #results, data = results })

Gateway Skills

Gateway Skills sind My Cool Proxys Implementierung von Agent Skills – wiederverwendbare Kontextdokumente, die Agenten als MCP-Ressourcen laden können. Wenn aktiviert, können Agenten:

• Fähigkeiten über einen automatisch eingefügten Prompt in den Serveranweisungen des Gateways entdecken (oder über die Lua-Eingebauten-Funktion _gateway.list_resources(); suchen Sie nach gw-skill://-URIs)

• Fähigkeitsinhalte über die Lua-Eingebauten-Funktion _gateway.read_resource() lesen

• Fähigkeitsskripte über die Lua-Eingebauten-Funktion _gateway.invoke_skill_script() ausführen

Während viele Agenten bereits eigene Fähigkeitssysteme implementieren, sind diese Systeme stark fragmentiert und es ist schwierig, dieselben Fähigkeiten über mehrere separate Agentenanwendungen hinweg wiederzuverwenden. Während einige Systeme wie skills.sh dies lösen, indem sie Fähigkeiten explizit zwischen Anwendungen kopieren, löst My Cool Proxy dies, indem es alle Fähigkeiten in seinem eigenen Fähigkeitsverwaltungssystem zentralisiert und über MCP bereitstellt. Um diese von vorhandenen Fähigkeitssystemen zu unterscheiden, bezeichnet My Cool Proxy sie als "Gateway Skills".

Gateway Skills sind standardmäßig deaktiviert, da sie mit vorhandenen Fähigkeitssystemen in Ihrem Agenten kollidieren können. Siehe Konfigurationsanleitung für Einrichtungsoptionen.

Eine tiefergehende Design-Diskussion darüber, warum Gateway Skills auf diese Weise implementiert sind, finden Sie in diesem Abschnitt in den Design-Dokumenten.

Web Dashboard

My Cool Proxy enthält ein optionales Web-Dashboard zur Überwachung der Gateway-Aktivität. Wenn es aktiviert ist, läuft es auf einem separaten Port und bietet:

• Ausführungsverlauf — Durchsuchen Sie alle Lua-Skriptausführungen mit syntaxhervorgehobenen Skripten und Ergebnissen

• Tool-Aufrufprotokoll — Sehen Sie, welche MCP-Tools bei jeder Ausführung aufgerufen wurden

• Sitzungsüberwachung — Aktive Sitzungen, verbundene Server und Fähigkeiten anzeigen

• Echtzeit-Updates — Neue Ausführungen werden per WebSocket an das Dashboard gestreamt

Aktivieren Sie es, indem Sie einen dashboard-Abschnitt zu Ihrer Konfiguration hinzufügen:

{
  "dashboard": {
    "port": 3100,
    "host": "localhost"
  }
}

Besuchen Sie dann http://localhost:3100 in Ihrem Browser. Siehe Konfigurationsanleitung für Details.

Konfiguration

Siehe die Konfigurationsanleitung für die vollständige Konfigurationsreferenz.

MCP-Funktionsunterstützungstabelle