What is EnrichMCP?
EnrichMCP 是一個強大的 Python 框架,旨在協助 AI 代理更有效地理解並操作您的資料。透過新增建立在 Model Context Protocol (MCP) 之上的語義層,EnrichMCP 將您現有的資料模型轉化為具類型、可探索的工具,其運作方式非常類似於專為 AI 應用程式量身打造的 ORM。它提供了一種穩健可靠的方式,讓 AI 代理能夠清晰且精確地導航和利用您的資料。
主要功能
EnrichMCP 為您提供不可或缺的工具,以建立用於 AI 代理的智慧型資料介面:
🔍 自動結構探索: 賦能 AI 代理即時探索並理解您完整的資料模型結構。此功能透過單一、簡單的呼叫,提供詳細說明實體、欄位、型別和關聯的完整結構描述。
🔗 關聯導航: 只需定義一次資料實體之間的關聯(例如
User到Order或Order到Product),EnrichMCP 就能讓 AI 代理自然且高效地遍歷這些連接。🛡️ 型別安全與驗證: 透過對所有輸入和輸出應用全面的 Pydantic 驗證,確保資料完整性和可靠性。您可以定義嚴格的資料型別、約束(例如最小值、特定格式如
EmailStr)以及允許的文字值,確保由代理處理的資料符合您的要求。✏️ 可變性與 CRUD: 控制 AI 代理如何修改資料。欄位預設為不可變,但您可以明確地將其標記為可變。EnrichMCP 會自動產生補丁模型,簡化安全地建立、更新和刪除資料記錄的過程。
📄 內建分頁: 透過實作內建分頁,輕鬆處理大型資料集。這使得 AI 代理能夠以可管理的區塊檢索資料,在處理大量資料集合時,提升效能和可用性。
🔐 上下文與驗證: 將必要的上下文,例如驗證詳細資訊、資料庫連線或其他所需資源,傳遞至您的資料操作中。這讓您能夠實作細緻的存取控制,並根據代理的上下文整合自訂邏輯。
使用案例
EnrichMCP 提供靈活的途徑,將 AI 代理的資料存取整合到您現有架構中,或建立全新、複雜的資料層:
轉化現有 SQLAlchemy 模型: 快速將您目前的 SQLAlchemy 資料模型公開為一個 AI 可導航的 API。只需在您的聲明式基礎中新增一個 mixin,EnrichMCP 便會自動產生必要的工具和解析器,讓代理能夠查詢、篩選和遍歷 ORM 中定義的關聯。
封裝現有 REST APIs: 在您現有的 REST APIs 之上新增一個語義層,而無需修改其核心邏輯。使用 EnrichMCP 模型定義您的資料實體、指定關聯,並編寫呼叫您 API 的簡單解析器函數。EnrichMCP 隨後提供一個結構化、型別安全的介面,供 AI 代理與您的 API 資料互動。
建構自訂資料層: 建構一個客製化的資料層,包含複雜的業務邏輯和計算欄位。定義包含標準欄位和計算欄位(例如
lifetime_value、churn_risk)的實體。實作自訂解析器以獲取資料、計算值或整合外部服務(如機器學習模型),為代理提供一個豐富、智慧的資料介面。
為何選擇 EnrichMCP?
EnrichMCP 透過三個關鍵層,強化了核心的 Model Context Protocol (MCP),這些層專為穩健的 AI 代理互動而設計:
語義層: 使 AI 代理能夠理解您資料的 意義 及其關聯,超越單純的結構感知。
資料層: 提供型別安全的模型、透過 Pydantic 進行內建驗證,以及清晰的關聯定義,以實現可靠的資料處理。
控制層: 整合了基本功能,例如驗證、分頁以及嵌入自訂業務邏輯的能力,讓您對資料存取和操作擁有精確的控制。
結果是一個框架,讓 AI 代理能夠像開發人員使用傳統 Object-Relational Mapper (ORM) 一樣,自然且有效地處理您的資料。
結論
EnrichMCP 提供一個結構化、型別安全且語義豐富的框架,用於將 AI 代理連接到您的資料。無論您是利用現有資料庫還是建立自訂資料介面,EnrichMCP 都提供工具,讓您的資料對於智慧型應用程式而言,既可探索又可用。





