注
.NET AG-UI統合に関する MCP Apps の互換性に関するドキュメントは近日公開予定です。
Agent Framework Python AG-UI エンドポイントは、AG-UI エコシステムの MCP Apps 機能と互換性があります。 MCP アプリを使用すると、フロントエンド アプリケーションは、AG-UI エージェントと共に MCP を利用したツールとリソースを埋め込むことができます。Python側で変更は必要ありません。
アーキテクチャ
MCP アプリのサポートは、フロントエンドと Agent Framework バックエンドの間にある 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 Apps レイヤーを認識できません。
Python側の変更は必要ありません
MCP Apps の統合は、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 アプリを使用するには、Python エンドポイントをポイントする、MCPAppsMiddlewareを含む 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 Apps ミドルウェアは TypeScript レイヤーでのみ実行されます。 - iframe プロキシされた MCP 要求の FastAPI 処理なし: リソース プロキシは、Node.js ミドルウェアによって処理されます。
-
Python側の
ui/resourceUri検出: リソース URI の解決はミドルウェアの責任です。
アプリケーションで MCP Apps ミドルウェア レイヤーが必要ない場合、Agent Framework AG-UI エンドポイントは AG UI と互換性のあるクライアントと直接連携します。