mcpgraph

mcpGraph 是一個強大的 Model Context Protocol (MCP) 宣告式框架，讓使用者無需編寫自訂程式碼即可建立複雜的代理工作流。透過在 YAML 中將 MCP 工具定義為節點有向圖，它能實現多個 MCP 伺服器的無縫編排、利用 JSONata 進行複雜的資料轉換，以及使用 JSON Logic 進行智慧路由決策。此方案專為希望將模組化工具組合成高效、可觀測的代理後端的工程師與開發者設計，同時保持嚴格的安全性與可追溯性。它提供了一種視覺化且宣告式的結構，讓開發者能以更易於測試、稽核與除錯的方式替代傳統的程式碼開發。

• 串聯多個 MCP 工具以自動處理多步驟任務。

• 使用 JSONata 表達式在工具輸出與輸入之間實現資料轉換管道。

• 利用 JSON Logic 定義複雜的路由邏輯，處理條件式分支與決策。

• 確保完全的可觀測性，追蹤每個節點的執行過程，包含輸入、輸出與中間狀態。

• 維持標準化的設定檔，與現有的 MCP 用戶端（如 Claude Desktop）完全相容。

• 採用模組化、宣告式的方法，從簡單且可重用的工具定義中建構複雜的代理功能。

• 設定完全透過 YAML 進行，便於版本控制與重複執行。

• 執行引擎支援自訂執行限制，如最大節點迭代次數與執行超時，以防止無窮迴圈。

• 標準輸出包含結構化的執行歷史、時間數據與完整的日誌，便於除錯。

• 需要在本機安裝 mcpGraph 命令列工具，或透過標準 MCP 用戶端設定進行整合。

• 專為開發大型語言模型 (LLM) 代理的開發者設計，適用於需要多工具互動、資料解析與邏輯複雜的任務自動化場景。

• 可與現有的 MCP 生態系統元件無縫整合，包括檔案系統及各種基於 API 的伺服器。