Zgodność aplikacji MCP z AG-UI

Narzędzie MAF nie zapewnia konfiguracji ani zachowania środowiska uruchomieniowego specyficznego dla aplikacji MCP. Obsługa aplikacji MCP jest implementowana przez oprogramowanie pośredniczące poza punktem końcowym AG-UI MAF, który nadal odbiera standardowe żądania AG-UI.

W przypadku wymagań dotyczących konfiguracji i zgodności oprogramowania pośredniczącego należy użyć dokumentacji wybranego klienta AG-UI lub oprogramowania pośredniczącego.

Punkty końcowe platformy Agent Framework Python AG-UI są zgodne z funkcją ekosystemu AG-UI, MCP Apps. Aplikacje MCP umożliwiają aplikacjom frontonu osadzanie narzędzi i zasobów opartych na programie MCP wraz z agentem AG-UI — bez konieczności wprowadzania zmian po stronie Python.

Architecture

Obsługa aplikacji MCP jest zapewniana przez bibliotekę TypeScript MCPAppsMiddleware (@ag-ui/mcp-apps-middleware), która znajduje się między frontonem a zapleczem platformy Agent Framework:

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

Warstwa oprogramowania pośredniczącego obsługuje odnajdywanie narzędzi MCP, żądania zasobów przekazywanych przez pośrednika iframe oraz ui/resourceUri obsługę. Punkt końcowy interfejsu AG-UI w Pythonie odbiera standardowe żądania AG-UI i nie rozpoznaje warstwy aplikacji MCP.

Brak wymaganych zmian po stronie Python

Integracja aplikacji MCP jest w pełni obsługiwana przez oprogramowanie pośredniczące TypeScript. Twoja konfiguracja add_agent_framework_fastapi_endpoint() działa bez zmian.

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

Takie podejście jest zgodne ze sposobem współdziałania aplikacji MCP z wszystkimi innymi integracjami AG-UI w Pythonie — warstwa aplikacji MCP jest zawsze w warstwie pośredniej TypeScript, a nie w back-endzie Pythona.

Konfigurowanie oprogramowania pośredniczącego

Aby używać aplikacji MCP z zapleczem platformy Agent Framework, skonfiguruj środowisko uruchomieniowe CopilotKit lub serwer proxy Node.js zawierający MCPAppsMiddleware i wskazujący na Twój punkt końcowy w Pythonie.

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

Aby uzyskać pełne instrukcje dotyczące konfiguracji, zobacz dokumentację aplikacji CopilotKit MCP Oraz dokumentację protokołów agentówAG-UI.

Co nie znajduje się w zakresie

Poniżej przedstawiono elementy, które nie są częścią integracji Python AG-UI:

  • No Python MCPAppsMiddleware: Pośrednik MCP Apps działa tylko w warstwie TypeScript.
  • Brak obsługi żądań MCP proxyowanych przez iframe w FastAPI: Proxying zasobów jest realizowany przez oprogramowanie pośredniczące Node.js.
  • No Python-side ui/resourceUri discovery: Rozpoznawanie identyfikatora URI zasobów jest kwestią warstwy pośredniej.

Jeśli Twoja aplikacja nie potrzebuje warstwy pośredniej MCP Apps, końcowy punkt AG-UI platformy Agent Framework działa bezpośrednio z dowolnym klientem zgodnym z AG-UI.

Następne kroki

Zarządzanie stanem

Dodatkowe zasoby

Narzędzie MAF Go nie zapewnia konfiguracji ani zachowania środowiska uruchomieniowego specyficznego dla aplikacji MCP. Obsługa aplikacji MCP jest implementowana przez oprogramowanie pośredniczące poza punktem końcowym AG-UI MAF.

  • Last updated on