Partekatu honen bidez:

Compatibilidad de aplicaciones de MCP con AG-UI

Nota:

La documentación de compatibilidad de aplicaciones de MCP para la integración de .NET AG-UI estará disponible próximamente.

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 de configuración completas, consulte la documentación de MCP Apps de CopilotKit y la documentación de AG-UI MCP Apps.

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

  • Last updated on