MCP

Conecta las herramientas proporcionadas por los servidores de Model Context Protocol (MCP) a tu agente.

MCP (Model Context Protocol) es un estándar de código abierto diseñado por Anthropic para conectar tus agentes a proveedores de servicios externos, como la base de datos de tu aplicación o APIs externas.

Gracias a este protocolo puedes poner a disposición de tu agente las herramientas expuestas por un servidor externo.

Las empresas pueden crear servidores MCP para permitir a los desarrolladores conectar agentes a sus plataformas. Aquí tienes un par de directorios con los servidores MCP más usados:

• GitHub oficial de MCP - https://github.com/modelcontextprotocol/servers

• Registro MCP-GET - https://mcp-get.com/

Cómo funciona

Neuron te proporciona el McpConnector clase que puedes instanciar pasando la configuración del servidor MCP.

use NeuronAI\MCP\McpConnector;

class MyAgent extends Agent 
{
    ...
    
    protected function tools(): array
    {
        return [
            ...McpConnector::make([
                'command' => 'php',
                'args' => ['/home/code/mcp_server.php'],
            ])->tools(),
        ];
    }
}

Debes crear una McpConnector instancia para cada servidor MCP con el que quieras interactuar.

Neuron descubre automáticamente las herramientas expuestas por el servidor y las conecta a tu agente.

Cuando el agente decide ejecutar una herramienta, Neuron generará la solicitud adecuada para llamar a la herramienta en los servidores MCP y devolverá el resultado al LLM para continuar la tarea. Se siente exactamente igual que con tus propias herramientas definidas, pero puedes acceder a un enorme catálogo de acciones predefinidas que tu agente puede realizar con solo una línea de código.

Servidor MCP local

Si quieres conectarte con un servidor MCP instalado localmente en tu máquina o VM, puedes usar la configuración de estilo "command".

use NeuronAI\MCP\McpConnector;

class MyAgent extends Agent 
{
    ...
    
    protected function tools(): array
    {
        return [
            ...McpConnector::make([
                'command' => 'php',
                'args' => ['/home/code/mcp_server.php'],
            ])->tools(),
        ];
    }
}

Servidor MCP remoto

Servidor HTTP transmisible

Los servidores remotos son accesibles mediante URLs y normalmente requieren autenticación. Puedes usar el token campo en el arreglo de configuración, que se usará como el token de autorización para autenticarse en el servidor:

use NeuronAI\MCP\McpConnector;

class MyAgent extends Agent 
{
    ...
    
    protected function tools(): array
    {
        return [
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
                'token' => 'BEARER_TOKEN',
                'timeout' => 30,
                'headers' => [
                    //'x-cutom-header' => 'value'
                ]
            ])->tools(),
        ];
    }
}

Transporte HTTP SSE

SSE (Eventos enviados por el servidor) es un mecanismo que permite a los clientes web recibir actualizaciones automáticas desde un servidor. Esas actualizaciones se conocen como "eventos" y se envían a través de una única conexión HTTP de larga duración.

Para usar el transporte SSE necesitas configurar async ⇒ true en los parámetros de configuración.

use NeuronAI\MCP\McpConnector;

class MyAgent extends Agent 
{
    ...
    
    protected function tools(): array
    {
        return [
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
                'token' => 'BEARER_TOKEN',
                'timeout' => 30,
                'async' => true
            ])->tools(),
        ];
    }
}

Monitorización y depuración

Muchas de las aplicaciones que construyas con Neuron contendrán varios pasos con múltiples invocaciones de llamadas a LLM. A medida que estas aplicaciones se vuelven cada vez más complejas, resulta crucial poder inspeccionar exactamente qué está ocurriendo dentro de tu sistema agéntico. La mejor manera de hacerlo es con Inspector.

Neuron AI | Inspectordocs.inspector.dev

Filtra la lista de herramientas

Durante la conexión con servidores MCP complejos, pueden incluir herramientas que podrían dar lugar a un comportamiento no deseado en contextos específicos. Los exclude() y only() métodos abordan este desafío de forma elegante, permitiendo a los desarrolladores conectarse con servidores MCP completos mientras mantienen un control detallado sobre las capacidades disponibles que deseas proporcionar a tu agente.

Esto resulta especialmente útil cuando se trabaja con agentes especializados que necesitan capacidades específicas, pero quieres reducir la probabilidad de un error del agente y reducir el consumo de tokens.

Estos métodos aceptan una lista de nombres de herramientas que quieres o no quieres asociar con el agente.

class MyAgent extends Agent 
{
    ...
    
    protected function tools()
    {
        return [
            // EXCLUIR: descarta ciertas herramientas
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
            ])->exclude([
                'tool_name_1',
                'tool_name_2',
            ])->tools(),
            
            // SOLO: Selecciona las herramientas que quieres incluir
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
            ])->only([
                'tool_name_1',
                'tool_name_2',
            ])->tools(),
        ];
    }
}