My Cool Proxy

My Cool Proxy es una puerta de enlace de servidor Model Context Protocol (MCP) que intenta resolver muchos de los problemas percibidos con MCP tal como existe hoy. Sin ningún orden en particular, estos son:

• Las descripciones de herramientas inflan la ventana de contexto: Este es un problema con la forma en que la mayoría de los agentes se integran con MCP. En lugar de implementar abstracciones que permitan cargar herramientas según sea necesario, la mayoría de las aplicaciones vuelcan todas las herramientas MCP en el contexto a la vez. Para mitigar esto, My Cool Proxy envuelve las herramientas en un intérprete de Lua y expone herramientas de nivel superior para descubrir herramientas de forma incremental. Consulta Divulgación progresiva para obtener más información.

• Los resultados de las herramientas inflan la ventana de contexto, ¿por qué no usar Bash? En lugar de usar herramientas MCP, los agentes podrían simplemente ejecutar comandos de terminal y usar bash para filtrar sus resultados; sin embargo, esto implica permitir que el agente realice acciones de alto riesgo con más frecuencia. Por ejemplo, podrías permitir que un agente use la CLI gh para interactuar con GitHub, pero también puede usar la CLI gh para realizar operaciones de modificación o destructivas. Con el GitHub MCP Server, puedes limitar fácilmente el alcance a herramientas de solo lectura. MCP te permite controlar estrictamente a qué herramientas tienen acceso los agentes. Para ayudar con esto, My Cool Proxy te permite filtrar aún más las herramientas expuestas a los agentes.

• La mayoría de las características de MCP no son compatibles: Desafortunadamente, la mayoría de las aplicaciones solo exponen herramientas MCP a los agentes, ignorando las otras características de cliente y servidor que ofrece el protocolo. My Cool Proxy pretende ser una capa de abstracción común para la mayor cantidad posible de características del protocolo, lo que permite a los desarrolladores usar las capacidades completas de MCP en cualquier aplicación compatible con MCP. Esto es un trabajo en curso; consulta la tabla de soporte de características para más detalles.

• Gestionar un archivo de configuración para múltiples agentes es un quebradero de cabeza: Si usas más de una aplicación compatible con MCP, rápidamente te encontrarás con dificultades para mantener sincronizada la configuración de tu servidor MCP entre ellas. My Cool Proxy resuelve esto actuando como un único punto de integración para cada servidor que uses, reduciendo el número de servidores que mantener sincronizados a solo uno.

Inicio rápido

0. Instalación

Instálalo globalmente para usarlo como herramienta CLI:

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

O ejecútalo directamente con npx:

npx @karashiiro/my-cool-proxy

1. Configuración

La puerta de enlace crea automáticamente una configuración predeterminada en el primer inicio. Simplemente ejecútalo una vez para generar el archivo de configuración:

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

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

Luego edita la configuración para añadir tus servidores MCP.

Estructura de configuración de ejemplo:

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

O copia la configuración de ejemplo para un punto de partida más completo.

2. Ejecución

# If installed globally
my-cool-proxy

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

3. Conexión

Añádelo a la configuración de tu cliente MCP, por ejemplo, en Claude Desktop:

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

4. Uso

Pide a tu agente que realice una tarea con la que tus servidores MCP configurados puedan ayudarte, ¡y observa cómo lo hace!

Divulgación progresiva

Este proxy actúa como una puerta de enlace entre los agentes y varios servidores MCP (Model Context Protocol). En lugar de conectarse a cada servidor MCP individualmente, los agentes se conectan a este único proxy y obtienen acceso a todos los servidores configurados a través de una interfaz unificada.

Los agentes comienzan con un conocimiento mínimo sobre qué servidores o herramientas están disponibles. Construyen el contexto de forma progresiva:

1. Consulta las instrucciones del servidor: My Cool Proxy precarga un pequeño mensaje con extractos breves de los servidores y herramientas configurados para preparar al agente para que los use.

2. Llama a list-servers: el contexto del agente ahora incluye nombres y descripciones de todos los servidores MCP disponibles (p. ej., "github", "slack", "database")

3. Llama a list-server-tools(server_name): el contexto del agente se expande para incluir todos los nombres y descripciones de herramientas para ese servidor específico.

4. Llama a tool-details(server_name, tool_name): el contexto del agente ahora tiene esquemas de parámetros completos, tipos de retorno (si están disponibles) y ejemplos de uso para una herramienta específica.

5. Llama a execute(lua_script): con el contexto completo, el agente puede escribir scripts de Lua que llamen a las herramientas descubiertas

En lugar de cargar todas las herramientas y sus descripciones en el contexto de antemano, esto difiere la carga de herramientas hasta que el agente determina que son necesarias.

Encadenamiento de herramientas con Lua: Una vez que un agente sabe qué herramientas existen, puede componer flujos de trabajo complejos de varios pasos en una sola llamada a execute(), ahorrando la sobrecarga de contexto de cualquier resultado intermedio de herramientas. El entorno de ejecución de Lua proporciona acceso a todos los servidores descubiertos como variables globales, con herramientas invocables como funciones asíncronas.

Encadenamiento secuencial de herramientas:

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

Lógica condicional:

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

Iteración con bucles:

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

Gateway Skills

Gateway Skills son la implementación de Agent Skills por parte de My Cool Proxy: documentos de contexto reutilizables que los agentes pueden cargar como Recursos MCP. Cuando están habilitadas, los agentes pueden:

• Descubrir habilidades a través de un mensaje inyectado automáticamente en las instrucciones del servidor de la puerta de enlace (o mediante la función integrada de Lua _gateway.list_resources(); busca URIs gw-skill://)

• Leer el contenido de las habilidades mediante la función integrada de Lua _gateway.read_resource()

• Ejecutar scripts de habilidades mediante la función integrada de Lua _gateway.invoke_skill_script()

Si bien muchos agentes ya implementan sus propios sistemas de habilidades, estos sistemas están muy fragmentados y es difícil reutilizar las mismas habilidades en múltiples aplicaciones de agentes separadas. Mientras que algunos sistemas como skills.sh resuelven esto copiando habilidades entre aplicaciones explícitamente, My Cool Proxy lo resuelve centralizando todas las habilidades en su propio sistema de gestión de habilidades y exponiéndolas a través de MCP. Para distinguirlas de los sistemas de habilidades existentes, My Cool Proxy las denomina «Gateway Skills».

Las Gateway Skills están deshabilitadas por defecto, ya que pueden entrar en conflicto con los sistemas de habilidades existentes integrados en tu agente. Consulta la Guía de configuración para conocer las opciones de configuración.

Para una discusión de diseño más profunda sobre por qué las Gateway Skills se implementan de esta manera, consulta esta sección en la documentación de diseño.

Panel web

My Cool Proxy incluye un panel web opcional para supervisar la actividad de la puerta de enlace. Cuando está habilitado, se ejecuta en un puerto separado y proporciona:

• Historial de ejecuciones — Examina todas las ejecuciones de scripts de Lua, con scripts y resultados con resaltado de sintaxis

• Registro de llamadas a herramientas — Ve qué herramientas MCP se llamaron durante cada ejecución

• Supervisión de sesiones — Consulta sesiones activas, servidores conectados y capacidades

• Actualizaciones en tiempo real — Las nuevas ejecuciones se transmiten al panel a través de WebSocket

Actívalo añadiendo una sección dashboard a tu configuración:

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

Luego visita http://localhost:3100 en tu navegador. Consulta la Guía de configuración para más detalles.

Configuración

Consulta la Guía de configuración para la referencia completa de configuración.

Tabla de soporte de características de MCP