Compatibilità delle app MCP con AG-UI

MAF non fornisce la configurazione o il comportamento di runtime specifico delle app MCP. Il supporto per le app MCP è implementato da un middleware esterno all'endpoint MAF AG-UI, che continua a ricevere richieste AG-UI standard.

Per i requisiti di configurazione e compatibilità del middleware, usare la documentazione per il client o il middleware AG-UI selezionato.

Gli endpoint Python AG-UI di Agent Framework sono compatibili con la funzionalità MCP Apps dell'ecosistema di AG-UI. Le app MCP consentono alle applicazioni front-end di incorporare risorse e strumenti basati su MCP insieme all'agente AG-UI, senza alcuna modifica sul lato Python.

Architecture

Il supporto delle app MCP è fornito da TypeScript MCPAppsMiddleware di CopilotKit (@ag-ui/mcp-apps-middleware), che si trova tra il front-end e il back-end di Agent Framework:

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

Il livello middleware gestisce l'individuazione degli strumenti MCP, le richieste di risorse tramite proxy iframe e la risoluzione di ui/resourceUri. L'endpoint Python AG-UI riceve richieste di AG-UI standard e non è a conoscenza del livello app MCP.

Mantenere l'endpoint Python standard

L'integrazione delle app MCP viene gestita dal middleware TypeScript. L'endpoint Python non richiede alcun comportamento specifico delle app MCP, ma Agent Framework 1.23 richiede comunque la dichiarazione standard di proprietà dell'autorizzazione AG-UI:

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)

# Local/single-user example. Shared services must use authorization_scope_resolver.
add_agent_framework_fastapi_endpoint(app, agent, "/", single_user=True)

Questo approccio è coerente con il funzionamento delle app MCP con tutte le altre integrazioni AG-UI Python: il livello MCP Apps è sempre nel middleware TypeScript, non nel back-end Python.

Configurazione del middleware

Per utilizzare le app MCP con il back-end di Agent Framework, configura un runtime CopilotKit o un proxy Node.js che includa MCPAppsMiddleware e indirizzi verso l'endpoint 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
  ],
});

Per istruzioni complete per la configurazione, consulta la documentazione di CopilotKit MCP Apps e la documentazione dei protocolli agentici di AG-UI.

Che cos'è non incluso nell'ambito

Di seguito sono esplicitamente non parte dell'integrazione Python AG-UI:

  • No Python MCPAppsMiddleware: il middleware delle app MCP viene eseguito solo nel livello TypeScript.
  • Nessuna gestione FastAPI delle richieste MCP tramite proxy iframe: il proxy delle risorse viene gestito dal middleware Node.js.
  • Nessuna individuazione di ui/resourceUri lato Python: la risoluzione degli URI delle risorse è gestita dal middleware.

Se l'applicazione non richiede il livello middleware di MCP Apps, l'endpoint AG-UI dell'Agent Framework funziona direttamente con qualsiasi client compatibile con AG-UI.

Passaggi successivi

Gestione dello Stato

Risorse aggiuntive

MAF Go non fornisce la configurazione o il comportamento di runtime specifico delle app MCP. Il supporto delle app MCP viene implementato dal middleware all'esterno dell'endpoint AG-UI MAF.

  • Ultimo aggiornamento: