Ralph-Loop-Ultra

mcp-tool-manager 是一個專為自主智能體設計的複雜工具，用於管理開發工作流程中的服務依賴項。它作為一個抽象層，使開發人員和 AI 智能體能夠在生產環境的即時 API 與沙盒模擬環境之間切換，而無需修改核心應用程式邏輯。此技能對於在 CI/CD 流程、本地除錯和整合測試期間維持高開發效率至關重要，特別是在 Stripe、AWS 或 Twilio 等外部服務受限流、成本考量或無法連線的情況下。

該技能透過模型上下文協定 (MCP) 標準化智能體與外部系統的互動方式。它提供了一種結構化機制，用於定義「即時 (live)」與「模擬 (mock)」模式的配置，允許智能體根據當前的環境變數動態載入相應的 JSON 工具定義。此外，它支援智慧化的自動生成工作流程，智能體可讀取 OpenAPI 規範並即時合成模擬工具，確保在引入新外部依賴項時能將阻力降至最低。

• 實現真實 API 端點與模擬工具集之間的無縫熱切換。

• 直接與 Claude Code 生態系統整合，透過 MCP 擴充智能體的能力。

• 提供利用 OpenAPI/Swagger 規範的自動化模擬生成工作流，減少手動編寫程式碼的負擔。

• 透過環境變數 (如 RALPH_MCP_MODE) 支援環境感知配置。

• 藉由允許智能體執行隔離的單元測試與整合測試，促進強大的測試模式。

• 當專案大量依賴第三方 SaaS 平台時，請使用此技能以防止對生產環境造成意外影響。

• 確保所有模擬工具均定義在 .ralph/ 目錄下，並符合 MCP 規範的標準 JSON 結構。

• 維持即時架構與模擬架構的一致性，確保自修正迴圈在從測試轉向部署的過程中依然有效。

• 設定 CLAUDE.md 檔案，將服務別名映射到對應的即時或模擬端點。

• 智能體預期環境變數設定正確以切換生產與開發模式；請在執行長週期的自動化任務前進行驗證。