메모
.NET AG-UI 통합에 대한 MCP 앱 호환성 설명서는 곧 제공될 예정입니다.
에이전트 프레임워크 Python AG-UI 엔드포인트는 AG-UI 에코시스템의 MCP 앱 기능과 호환됩니다. MCP 앱을 사용하면 프런트 엔드 애플리케이션이 AG-UI 에이전트와 함께 MCP 기반 도구 및 리소스를 포함할 수 있으며 Python 쪽에서 변경이 필요하지 않습니다.
아키텍처
MCP 앱 지원은 프런트 엔드와 에이전트 프레임워크 백 엔드 사이에 있는 CopilotKit의 TypeScript MCPAppsMiddleware (@ag-ui/mcp-apps-middleware)에서 제공됩니다.
┌─────────────────────────┐
│ Frontend │
│ (CopilotKit / AG-UI) │
└────────┬────────────────┘
│
▼
┌─────────────────────────┐
│ CopilotKit Runtime / │
│ Node.js Proxy │
│ + MCPAppsMiddleware │
└────────┬────────────────┘
│ AG-UI protocol
▼
┌─────────────────────────┐
│ Agent Framework │
│ FastAPI AG-UI Endpoint │
└─────────────────────────┘
미들웨어 계층은 MCP 도구 검색, iframe 프록시 리소스 요청 및 ui/resourceUri 해결을 처리합니다. Python AG-UI 엔드포인트는 표준 AG-UI 요청을 수신하며 MCP 앱 계층을 인식하지 못합니다.
Python 쪽 변경이 필요하지 않음
MCP 앱 통합은 TypeScript 미들웨어에서 완전히 처리됩니다. 기존 add_agent_framework_fastapi_endpoint() 설정은 그대로 작동합니다.
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, "/")
이 방법은 MCP Apps가 다른 모든 AG-UI Python 통합과 작동하는 방식과 일치합니다. MCP Apps 계층은 항상 Python 백 엔드가 아닌 TypeScript 미들웨어에 있습니다.
미들웨어 설정
에이전트 프레임워크 백 엔드에서 MCP 앱을 사용하려면 MCPAppsMiddleware 및 Python 엔드포인트를 포함하는 CopilotKit 런타임 또는 Node.js 프록시를 설정합니다.
// 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
],
});
전체 설정 지침은 CopilotKit MCP Apps 설명서 및 AG-UI MCP Apps 설명서를 참조하세요.
범위에 없는 내용
다음은 명시적으로 Python AG-UI 통합의 아닌 부분입니다.
-
Python 없음
MCPAppsMiddleware: MCP 앱 미들웨어는 TypeScript 계층에서만 실행됩니다. - iframe 프록시 MCP 요청의 FastAPI 처리 없음: 리소스 프록시는 Node.js 미들웨어에서 처리됩니다.
Python 측 발견 없음 : 리소스 URI 확인은 미들웨어의 문제입니다.
애플리케이션에 MCP 앱 미들웨어 계층이 필요하지 않은 경우 에이전트 프레임워크 AG-UI 엔드포인트는 AG-UI 호환 클라이언트에서 직접 작동합니다.