Proxy Meta MCP

Un proxy flexible de Protocolo de Contexto de Modelo (MCP) que permite el descubrimiento y la ejecución de herramientas en múltiples servidores MCP y funciones JavaScript. Esto permite tener un evento de contexto reducido si se tienen cientos de herramientas. Este MCP actúa como contenedor de otros MCP (o bibliotecas), realizando una especie de RAG local (Generación Aumentada de Recuperación) para reducir el tamaño del contexto, proporcionando al llm dos métodos (descubrir y ejecutar) y solicitando al llm que sea conciso en el descubrimiento. El método de ejecución es un proxy simple.

Recomendamos encarecidamente agregar la configuración discoverDescriptionExtras para ampliar los detalles sobre el propósito de las herramientas y para qué tipo de temas el llm debería usarlas.

Características

• 🌉 Descubrimiento unificado de herramientas : busque herramientas en varios servidores MCP

• 🔌 Ejecución de proxy : enruta las llamadas de la herramienta al servidor apropiado

• 🔍 Búsqueda inteligente : encuentre la mejor herramienta para el trabajo con coincidencia aproximada

• 🧩 Integración de JavaScript : exponga funciones de JavaScript personalizadas como herramientas MCP

• 📝 Configurable : Carga la configuración desde archivos o argumentos de la línea de comandos

Related MCP server: mcptool

Uso

🧱Instalación

Edite su archivo ~/Library/Application Support/Claude/claude_desktop_config.json

y añade lo siguiente

{
  "mcpServers": {
    "mcp-openapi-proxy": {
      "command": "npx",
      "args": ["@nullplatform/meta-mcp-proxy","-f","config.json"]
    }
  }
}

Formato del archivo de configuración

Su config.json debe seguir esta estructura:

{
  "discoverDescriptionExtras": "Additional description for discovery",
  "discoverLimit": 10,
  "mcpServers": {
    "server-name": {
      "command": "command-to-execute",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR1": "value1",
        "ENV_VAR2": "value2"
      },
      "transport": "stdio"
    }
  }
}

como ejemplo

{
  "discoverDescriptionExtras": "Api used to manage a pet store with access to pets, pet types, users, orders and store",
  "mcpServers": {
    "mcp-petstore": {
        "command": "uvx",
        "args": ["mcp-openapi-proxy"],
        "env": {
            "OPENAPI_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json",
            "API_KEY": "xxxxx"
       }
    }
  }
}

Ejemplo de conversación de 0 disparos con Claude

El ejemplo utiliza la configuración de demostración con la tienda de mascotas y casi no hay descripción de lo que hace la API.

Como biblioteca

También puedes utilizar Meta MCP Proxy como biblioteca en tus propias aplicaciones JavaScript:

import { MCPProxy } from '@nullplatform/meta-mcp-proxy';

// Create a new proxy instance
const mcpProxy = new MCPProxy({
  mcpServers: {
    "my-server": {
      "command": "path/to/server",
      "args": [],
      "env": {}
    }
  },
  discoverLimit: 10
});

// Register a custom JavaScript function
mcpProxy.registerJsFunction(
  "myFunction", 
  "Description of my function",
  {
    properties: {
      param1: {
        type: "string",
        description: "First parameter"
      },
      param2: {
        type: "number",
        description: "Second parameter"
      }
    },
    required: ["param1"]
  },
  async ({ param1, param2 }) => {
    // Implementation goes here
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({ result: `Processed ${param1}` })
        }
      ]
    };
  }
);

// Start the MCP server
await mcpProxy.startMCP();

Ejemplo de creación de un mcp con meta-mcp-proxy como biblioteca

Licencia

Instituto Tecnológico de Massachusetts (MIT)