Usa tu propio servidor de MCP para la arquitectura de referencia de kagent

Descripción general

Esta solución aborda la necesidad de un mecanismo estandarizado, seguro y escalable para integrar servidores del Protocolo de contexto del modelo (MCP) en entornos de Distributed Cloud solo de software (GDC) con kagent implementado como la plataforma de IA agéntica.

El problema principal que se aborda es la falta de una interfaz unificada para conectar aplicaciones de modelos de lenguaje grandes (LLM) a fuentes de datos y herramientas localizadas dentro de clústeres de GDC regulados. Esta arquitectura proporciona un framework de Bring Your Own (BYO) que permite a los desarrolladores implementar servidores de MCP personalizados que exponen capacidades empresariales específicas como herramientas para agentes de IA.

Esta arquitectura abarca los protocolos de comunicación entre kagent y los servidores de MCP, y la topología de los componentes en GDC. No incluye la lógica interna de los servidores de MCP de terceros.

El público objetivo de este documento incluye a los administradores de la plataforma de GDC, los desarrolladores de aplicaciones de IA y los revisores de seguridad responsables de aprobar las integraciones de herramientas externas.

Características y funciones

kagent proporciona un framework flexible que permite a las organizaciones usar servidores de MCP de BYO para integrar LLM con herramientas locales o de propiedad exclusiva. Con esta capacidad, los agentes pueden interactuar con fuentes de datos especializadas y realizar tareas complejas dentro del perímetro de un clúster de GDC.

Componentes funcionales y responsabilidades

La arquitectura incluye los siguientes componentes funcionales:

  • Plataforma de agentes de IA (kagent): Actúa como el organizador central. Administra el ciclo de vida de la sesión del agente, enruta las consultas de los usuarios al LLM y coordina la ejecución de las herramientas a través del cliente de MCP.
  • LLM: Controla la comprensión del lenguaje natural y el razonamiento. Determina cuándo se requiere una herramienta específica para completar una solicitud y genera los parámetros necesarios para llamar a esa herramienta.
  • Servidor de MCP: Expone herramientas específicas a través de MCP como un servicio independiente. Controla la lógica de bajo nivel de interacción con los sistemas empresariales de backend o los repositorios de datos.

Interfaces y flujo de datos

La arquitectura de extremo a extremo se basa en interfaces estandarizadas para mantener la interoperabilidad y la seguridad:

  • Transporte de MCP: kagent se comunica con el servidor de MCP usando JSON-RPC estandarizado a través de un transporte de MCP compatible, como HTTP transmisible (o HTTP con SSE) o stdio. Esta interfaz define cómo se descubren, describen y llaman las herramientas.
  • Flujo de datos: El ciclo de vida de la solicitud sigue estos pasos:
    1. El usuario envía una instrucción a kagent.
    2. kagent reenvía la instrucción al LLM.
    3. El LLM identifica una llamada a la herramienta y la devuelve a kagent.
    4. kagent reenvía la solicitud al servidor de MCP.
    5. El servidor de MCP ejecuta la herramienta en la fuente de datos local y devuelve el resultado.
    6. El kagent envía el resultado de vuelta al LLM para generar la respuesta final.

Arquitectura

Para demostrar cómo implementar y usar un servidor de MCP propio, esta arquitectura de referencia usa la aplicación de código abierto Nextcloud, su servidor de MCP y el agente de Nextcloud en Solo Enterprise para kagent.

En este ejemplo, se entrega el modelo Gemma 4 con vLLM.

La arquitectura conecta Nextcloud, kagent y el modelo Gemma 4 dentro del entorno de GDC. En esta configuración, kagent usa Nextcloud como repositorio de datos para que el modelo de Gemma 4 pueda acceder a la información en Nextcloud y procesarla a través de interfaces de MCP estandarizadas.

Nextcloud es una plataforma de colaboración y almacenamiento en la nube de código abierto y autohospedada que admite la implementación local para ayudarte a mantener el control y la privacidad de los datos de los usuarios. Es un componente de openDesk.

Nextcloud incluye las siguientes funciones:

  • Sincronización y uso compartido de archivos: Almacena archivos, sincronízalos en computadoras y dispositivos móviles a través de apps dedicadas y compártelos con vínculos.
  • Herramientas de productividad: Usa el calendario, los contactos, la administración de tareas y los clientes de correo electrónico integrados.
  • Colaboración: Integra paquetes de oficina, como Collabora Online u ONLYOFFICE, directamente en Nextcloud para coeditar documentos, hojas de cálculo y presentaciones en tiempo real.
  • Extensibilidad: Instala complementos desde la tienda de aplicaciones para agregar funciones, como administradores de contraseñas, tableros Kanban o reproductores de música.

Esta solución requiere GDC con kagent y vLLM que entreguen el modelo Gemma 4. En el siguiente diagrama, se ilustra la configuración de la validación:

Configuración de validación con GDC, kagent, Nextcloud y vLLM que entrega Gemma 4.

Materiales adicionales