mcp-agent 是一個簡潔且可組合的 Python 框架,旨在幫助開發者使用模型內容協定 (Model Context Protocol, MCP) 和一系列高效的工作流模式 (workflow patterns) 來建構強大的人工智慧代理 (AI Agents)。
該專案的靈感來源於兩大基石:
mcp-agent 將這兩大理念融合到一個實用的框架中,讓開發者能專注於應用的核心邏輯,而非底層的複雜性。
核心概念與功能
自動化的 MCP 管理:
框架處理了連接、管理和關閉 MCP 伺服器生命週期的所有繁瑣事務。開發者只需在設定檔中聲明需要哪些伺服器 (如檔案系統、網頁抓取等),mcp-agent 就會自動處理後續的一切。
可組合的工作流模式 (Composable Workflows):
mcp-agent 實作了 Anthropic 和 OpenAI 提出的多種經典代理模式,並將每種模式都設計成可互相組合的元件。這意味著你可以像堆疊樂高積木一樣,將簡單的模式組合成複雜的應用。主要模式包括:
以代理為中心的抽象 (Agent-centric Abstraction):
框架的核心是 Agent 物件。一個 Agent 被定義為一個具有特定目標 (instruction) 並被授權存取一組 MCP 工具的實體。開發者可以輕易地創建多個具有不同專長的代理。
支援人在迴路 (Human-in-the-Loop):
工作流可以在執行中途暫停,並透過一個特殊的工具 __human_input__ 向使用者請求輸入或批准,讓人為介入成為可能。
主要特點
if/else 和 while 迴圈來編寫邏輯,而不是學習複雜的圖形化介面。AugmentedLLM 物件,你可以輕易地將它們嵌套使用,例如,在「協調者」模式中使用「評估者-優化者」模式來產生更高品質的執行計畫。總結來說,mcp-agent 是一個為開發者設計的強大工具,它將業界領先的代理設計模式與標準化的 MCP 協議相結合,提供了一個既簡單又靈活的平台,用以建構可控、可靠且功能強大的 AI 代理應用。