Partager via

Compatibilité des applications MCP avec AG-UI

Note

La documentation de compatibilité mcP Apps pour l’intégration .NET AG-UI sera bientôt disponible.

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.

Aucune modification côté Python requise

L’intégration des applications MCP est entièrement gérée par l’intergiciel TypeScript. Votre configuration existante add_agent_framework_fastapi_endpoint() fonctionne as-is:

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, "/")

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 documentationAG-UI MCP Apps.

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

  • Last updated on