01—MCP 模組標準
一種模組模式,每個連接器都適用。
MCP_CONFIGURATION
每個模組透過統一的 MCP_CONFIGURATION 宣告暴露其能力:工具、資源和 prompts。編排主幹和審查流程因此確切知道該期待什麼。
- 工具、資源和 prompts 在 MCP_CONFIGURATION 中宣告
- 所有模組共享驗證、錯誤和速率限制模式
- 相容 Python 3.8+——模組可在老舊基礎設施上執行,無需升級執行環境
- 統一的測試要求:每個工具都有請求/回應測試和錯誤路徑覆蓋
02—連接器交付模式
每個連接器都以相同的營運姿態交付。
型別化用戶端 + 治理
- 型別化用戶端,具有顯式方法簽名和回傳型別
- 驗證處理:OAuth、API keys 和 mTLS 按連接器管理,絕不硬編碼
- httpx HTTP/2,帶指數退避和抖動
- 可插拔速率限制器(令牌桶、滑動窗口、按系統)
- 結構化錯誤,含 HTTP 狀態、供應商錯誤碼和重試分類
- 稽核日誌:每個請求和回應都記錄延遲和結果
- 測試覆蓋:針對沙箱的整合測試、針對錯誤路徑的 mock 測試
03—代理執行環境模式
編排主幹就是交付物。
AI 代理編排主幹 + 營運姿態
- 編排主幹協調代理、在 MCP 模組間路由工具分派並執行速率限制
- 系統 prompt 和工具描述與模組程式碼一起版本控制
- 用於多輪對話的工作階段儲存,保留時間可設定
- 每次工具呼叫的稽核日誌:請求、回應、延遲、結果
- 可觀測性:結構化日誌、指標和 traces 推送到您的監控堆疊
- 回退路徑:後端不可用時優雅降級
- 維運 runbook:部署、回滾、事件回應和常見操作
04—資料與知識圖譜模式
圖譜補充記錄系統;它從不取代。
Neo4j + Dagster
Neo4j 儲存靜態目錄圖譜:產品關係、供應商對應、替換規則和利潤配置。即時營運狀態(如庫存水位、訂單狀態、可用性)則留在它本該屬於的來源系統中。
- Neo4j 用於關係推理:替代供應商、替代零件、類別層級
- Dagster 用於 ELT:assets、ops、schedules 和 sensors——宣告式、版本化、可觀測
- S3 中 Hive 分區檔案、基於水位線的增量載入、冪等寫入
- dbt 用於向 Redshift / Athena 的轉換
- 即時狀態留在記錄系統中;圖譜不會成為第二真相源
06—合作形式
固定範圍階段、每週演示、明確的移交。
專案如何確定範圍
發掘階段為期一週,產出系統清單、工作流程地圖和建設計畫。首批建設通常共 5–8 週。您在承諾建設之前就已知完整範圍和成本,且每個階段都以可用軟體或具體移交物收尾。