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 文件，将服务别名映射到对应的实时或模拟端点。

• 智能体预期环境变量设置正确以切换生产与开发模式；请在执行长周期的自动化任务前进行验证。