Compatibilité des applications MCP avec AG-UI

MAF ne fournit pas de configuration ou de comportement d’exécution spécifique à MCP Apps. La prise en charge des applications MCP est assurée par un intergiciel en dehors du point de terminaison MAF AG-UI, qui continue de recevoir des requêtes AG-UI standard.

Pour les exigences de configuration et de compatibilité des intergiciels, utilisez la documentation relative à la AG-UI client ou intergiciel sélectionné.

Les points de terminaison de l'Agent Framework Python AG-UI sont compatibles avec la fonctionnalité MCP Apps de l'écosystème AG-UI. MCP Apps permet aux applications frontales d’incorporer des outils et des ressources basés sur MCP en même temps que votre agent de AG-UI, sans aucune modification nécessaire côté Python.

Architecture

La prise en charge des applications MCP est fournie par TypeScript MCPAppsMiddleware de CopilotKit (@ag-ui/mcp-apps-middleware), qui se trouve entre le serveur frontal et votre back-end Agent Framework :

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

La couche middleware gère la découverte d'outils MCP, les demandes de ressources utilisées par un proxy iframe et la résolution ui/resourceUri. Votre point de terminaison Python AG-UI reçoit des demandes AG-UI standard et ignore la couche Apps MCP.

Conserver l’endpoint Python standard

L’intégration des applications MCP est gérée par l’intergiciel TypeScript. Le point de terminaison Python n’a pas besoin d’un comportement spécifique aux applications MCP, mais Agent Framework 1.23 requiert toujours la déclaration de propriété d’autorisation standard 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)

Cette approche est cohérente avec le fonctionnement des applications MCP avec toutes les autres intégrations AG-UI Python : la couche Applications MCP est toujours dans le middleware TypeScript, et non dans le back-end Python.

Configuration du middleware

Pour utiliser mcP Apps avec votre back-end Agent Framework, configurez un proxy CopilotKit Runtime ou Node.js qui inclut MCPAppsMiddleware et pointe vers votre point de terminaison 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
  ],
});

Pour obtenir des instructions d’installation complètes, consultez la documentation copilotKit MCP Apps et la documentation sur les protocoles agentiquesAG-UI.

Ce qui n’est pas dans le périmètre

Les éléments suivants sont explicitement not partie de l’intégration Python AG-UI :

  • No Python MCPAppsMiddleware : l’intergiciel MCP Apps s’exécute uniquement dans la couche TypeScript.
  • Aucune gestion FastAPI des requêtes MCP iframe proxiées : le proxy de ressources est géré par l’intergiciel Node.js.
  • Pas de découverte côté Pythonui/resourceUri : la résolution de l’URI de ressource est une question d’intergiciel.

Si votre application n’a pas besoin de la couche middleware MCP Apps, votre framework agent AG-UI point de terminaison fonctionne directement avec n’importe quel client compatible AG-UI.

Étapes suivantes

Gestion de l’état

Ressources additionnelles

MAF Go ne fournit pas de configuration ou de comportement d’exécution spécifique à MCP Apps. La prise en charge des applications MCP est assurée par un intergiciel en dehors du point de terminaison MAF AG-UI.

  • Dernière mise à jour :