Compatibilidad de aplicaciones de MCP con AG-UI

MAF no proporciona una configuración o un comportamiento en tiempo de ejecución específicos de las aplicaciones de MCP. La compatibilidad con aplicaciones MCP se implementa mediante middleware fuera del punto de conexión de AG-UI de MAF, que sigue recibiendo solicitudes de AG-UI estándar.

Para conocer los requisitos de compatibilidad y configuración de middleware, use la documentación del cliente o middleware de AG-UI seleccionado.

Los puntos de conexión de Python AG-UI de Agent Framework son compatibles con la característica MCP Apps del ecosistema de AG-UI. Las aplicaciones de MCP permiten a las aplicaciones de front-end insertar herramientas y recursos basados en MCP junto con el agente de AG-UI, sin cambios necesarios en el lado Python.

Architecture

El TypeScript MCPAppsMiddleware de CopilotKit proporciona compatibilidad con aplicaciones MCP (@ag-ui/mcp-apps-middleware), que se encuentra entre el front-end y el back-end de Agent Framework:

┌─────────────────────────┐
│  Frontend               │
│  (CopilotKit / AG-UI)   │
└────────┬────────────────┘
         │
         ▼
┌─────────────────────────┐
│  CopilotKit Runtime /   │
│  Node.js Proxy          │
│  + MCPAppsMiddleware    │
└────────┬────────────────┘
         │ AG-UI protocol
         ▼
┌─────────────────────────┐
│  Agent Framework        │
│  FastAPI AG-UI Endpoint │
└─────────────────────────┘

La capa de middleware controla la detección de herramientas MCP, las solicitudes de recursos a través de un proxy de iframe y la resolución de ui/resourceUri. El punto de conexión de Python AG-UI recibe solicitudes estándar de AG-UI y no es consciente de la capa de aplicaciones MCP.

No se requieren cambios en la parte de Python

La integración de aplicaciones MCP se controla completamente mediante el middleware de TypeScript. La configuración existente add_agent_framework_fastapi_endpoint() funciona tal como está.

from agent_framework import Agent
from agent_framework.ag_ui import add_agent_framework_fastapi_endpoint
from fastapi import FastAPI

app = FastAPI()
agent = Agent(name="my-agent", instructions="...", client=chat_client)

# This endpoint is MCP Apps-compatible with no additional configuration
add_agent_framework_fastapi_endpoint(app, agent, "/")

Este enfoque es coherente con el funcionamiento de las aplicaciones de MCP con todas las demás integraciones de AG-UI Python: la capa aplicaciones de MCP siempre está en el middleware de TypeScript, no en el back-end de Python.

Configuración del middleware

Para usar aplicaciones de MCP con el back-end de Agent Framework, configure un proxy CopilotKit Runtime o Node.js que incluya MCPAppsMiddleware y apunte al punto de conexión de Python.

// Example Node.js proxy configuration (TypeScript)
import { MCPAppsMiddleware } from "@ag-ui/mcp-apps-middleware";

const middleware = new MCPAppsMiddleware({
  agents: [
    {
      name: "my-agent",
      url: "http://localhost:8888/",  // Your MAF AG-UI endpoint
    },
  ],
  mcpApps: [
    // MCP app configurations
  ],
});

Para obtener instrucciones completas de configuración, consulte la documentación de CopilotKit MCP Apps y la documentación sobre los protocolos agénticos de AG-UI.

Qué no está en el ámbito

A continuación se muestran explícitamente no son parte de la integración de Python AG-UI:

  • No Python MCPAppsMiddleware: el middleware de aplicaciones MCP solo se ejecuta en la capa de TypeScript.
  • No hay manejo de FastAPI para solicitudes MCP proxied por iframe: El middleware de Node.js se encarga de gestionar el proxy de recursos.
  • No Python ui/resourceUri discovery: la resolución del URI de recursos es un problema de middleware.

Si la aplicación no necesita la capa de middleware de Aplicaciones de MCP, el punto de conexión AG-UI de Agent Framework funciona directamente con cualquier cliente compatible con AG-UI.

Pasos siguientes

Administración de estados

Recursos adicionales

MAF Go no proporciona una configuración o un comportamiento en tiempo de ejecución específicos de APLICACIONES DE MCP. La compatibilidad con las aplicaciones MCP se implementa mediante una capa intermedia fuera del endpoint AG-UI de MAF.

  • Last updated on