Kompatibilita aplikací MCP s AG-UI

Poznámka:

Dokumentace k kompatibilitě aplikací MCP pro integraci .NET AG-UI bude brzy k dispozici.

Koncové body Python AG-UI Agent Framework jsou kompatibilní s funkcí MCP Apps ekosystému AG-UI. Aplikace MCP umožňují front-endovým aplikacím vkládat nástroje a prostředky MCP společně s vaším agentem AG-UI – na Python straně nejsou potřeba žádné změny.

Architecture

Podporu aplikací MCP poskytuje TypeScript MCPAppsMiddleware společnosti CopilotKit @ag-ui/mcp-apps-middleware, který se nachází mezi frontendem a backendem vaší Agent Frameworkové struktury.

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

Vrstva middlewaru zpracovává zjišťování nástrojů MCP, požadavky na prostředky iframe prostřednictvím ui/resourceUri a jejich vyřízení. Koncový bod Python AG-UI přijímá standardní požadavky AG-UI a neví o vrstvě APLIKACE MCP.

Nejsou potřebné žádné změny Python.

Integrace MCP Apps je plně zpracována middlewarem TypeScriptu. Vaše stávající add_agent_framework_fastapi_endpoint() nastavení funguje tak, jak je:

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

Tento přístup je konzistentní s tím, jak aplikace MCP fungují se všemi ostatními integracemi AG-UI Python – vrstva MCP Apps je vždy v middlewaru TypeScriptu, ne v back-endu Python.

Nastavení middlewaru

Pokud chcete používat aplikace MCP s Frameworkem backendu agenta, nastavte CopilotKit Runtime nebo proxy Node.js, která zahrnuje MCPAppsMiddleware a směřuje na koncový bod Pythonu.

// 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
  ],
});

Úplné pokyny k nastavení najdete v dokumentaci k aplikaci CopilotKit MCP Apps a dokumentaci kAG-UI MCP Apps.

Co není v oboru

Následující nejsou explicitně ne součástí integrace Python AG-UI:

  • No Python MCPAppsMiddleware: Middleware MCP Apps běží jenom ve vrstvě TypeScript.
  • Žádné zpracování požadavků MCP s rozhraním FastAPI: Proxy prostředků zpracovává middleware Node.js.
  • Pythonová strana ui/resourceUri detekce: Řešení identifikátorů URI prostředků je úkolem middleware.

Pokud vaše aplikace nepotřebuje vrstvu middlewaru MCP Apps, váš koncový bod Agent Framework AG-UI funguje přímo s jakýmkoli klientem kompatibilním s AG-UI.

Další kroky

Správa stavu

Další zdroje

  • Last updated on