Servidor MCP en Recuperación de agentes en Foundry local

La plataforma Recuperación de agentes incluye un servidor integrado del Protocolo de contexto del modelo (MCP) que expone capacidades de recuperación RAG como herramientas. Cualquier agente o cliente de IA compatible con MCP puede conectarse para buscar entre las colecciones incorporadas.

¿Qué es el Protocolo de Contexto Modelo?

MCP es un estándar abierto para conectar agentes de inteligencia artificial a herramientas externas y orígenes de datos. Define un protocolo basado en JSON-RPC 2.0 donde:

• Un servidor expone herramientas (funciones a las que pueden llamar los agentes) y recursos (puntos de conexión de datos).
• Un cliente detecta e invoca esas herramientas.

Esta arquitectura plug-and-play permite a los agentes conectarse a nuevos orígenes de datos sin modificaciones de código. Simplemente registre un nuevo servidor MCP.

Implementación del servidor MCP de recuperación agéntica

El servidor indexed-sources-mcp-server MCP integrado se ejecuta en el puerto 8080 y expone herramientas de búsqueda que consultan las colecciones ingeridas. También admite el consumo de servidores MCP externos registrándolos como orígenes de conocimiento, lo que permite a los agentes acceder a herramientas y datos desde cualquier servicio compatible con MCP.

Detalles del protocolo

El servidor MCP usa las siguientes especificaciones de protocolo:

Todas las llamadas a herramientas pasan por un único punto de conexión. El method campo del cuerpo de JSON-RPC determina la operación (initialize, tools/list, tools/call).

Herramientas de búsqueda integradas

El servidor MCP integrado expone seis herramientas de búsqueda que consultan las colecciones ingeridas:

Parámetros comunes

Todas las herramientas de búsqueda (excepto get_available_collections) aceptan:

Búsqueda en varias colecciones

Puede consultar varias colecciones en una sola solicitud pasando varios nombres en collection_names. Los resultados se devuelven con clave por nombre de colección:

{
  "my-docs": { "results": [...], "metadata": {...} },
  "other-docs": { "results": [...], "metadata": {...} }
}

Conexión al servidor MCP

Puede conectarse al servidor MCP mediante cualquier cliente compatible con MCP. El proceso de conexión implica un establecimiento de sesión en el que el cliente inicializa una sesión, enumera las herramientas disponibles y, a continuación, invoca las herramientas según sea necesario.

Desde un cliente compatible con MCP

La mayoría de los clientes MCP (por ejemplo, Claude Desktop, agentes personalizados) controlan automáticamente el ciclo de vida de la sesión. Configúrelos mediante URL: https://<cluster-domain>/edgeai/mcp.

Conexión manual mediante curl

MCP requiere un protocolo de enlace de sesión con estos tres pasos:

# 1. Initialize — capture the Mcp-Session-Id from response headers
curl -si -X POST https://<cluster-domain>/edgeai/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. List available tools
curl -s -X POST https://<cluster-domain>/edgeai/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <session-id-from-step-1>" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Call a tool
curl -s -X POST https://<cluster-domain>/edgeai/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <session-id-from-step-1>" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_hybrid","arguments":{"query":"How do I reset my device?","top_n":5}}}'

Redirección de puertos (desarrollo)

También puede conectarse al servidor MCP mediante el reenvío de puertos a su equipo local. Este método es útil para el desarrollo y las pruebas con herramientas como Postman o curl sin necesidad de administrar tokens de autenticación.

kubectl port-forward deployment/indexed-sources-mcp-server-deployment 8080:8080 -n arc-rag
# Then use http://localhost:8080/edgeai/mcp (no Authorization header needed)

Registro de servidores MCP externos

Los agentes de Agentic Retrieval pueden conectarse a servidores externos MCP registrándolos como fuentes de conocimiento con kind: remote_mcp. Este registro permite a los agentes acceder a herramientas y datos desde cualquier servicio compatible con MCP.

Use el siguiente comando para crear un origen de conocimiento para el servidor MCP externo:

curl -X POST https://<cluster-domain>/edgeai/knowledgesources \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "name": "my-external-mcp",
    "kind": "remote_mcp",
    "auth_type": "unauthenticated",
    "description": "External MCP server for custom tools",
    "remote_mcp_parameters": {
      "server_url": "https://external-mcp-server.example.com/mcp",
      "server_label": "my-external-server"
    }
  }'

Autenticación y seguridad

Puede conectarse al servidor MCP mediante la autenticación de token de portador o sin autenticación (para el reenvío de puertos).

Control de acceso

Tipos de autenticación admitidos para servidores MCP externos

Contenido relacionado

• Introducción a la capa agente