AgentBack - AI native API/MCP framework

AgentBack 是一个基于 ESM/Zod/MCP 的 LoopBack 4 分支，专为 AI 编码代理设计，帮助您从单一代码库构建 HTTP API 和 MCP 服务器。只需在装饰器上定义一次 Zod 模式，它就能自动生成请求验证、OpenAPI 3.1 规范、MCP 工具以及无需代码生成的类型化客户端——所有功能都来自同一个依赖注入容器。AI 编码代理获得了一个真正的契约来构建，从而避免了第二真相源或端点不匹配的问题。最佳实践成为阻力最小的路径。现已发布在 npm 上。

核心功能

AgentBack 的核心在于将 Zod 模式与装饰器深度集成，实现一次定义、多处复用。您只需在控制器方法上使用装饰器声明输入输出模式，框架便会自动完成请求验证、API 文档生成、MCP 工具注册和客户端类型推导。这种设计消除了传统开发中维护多个配置文件（如 OpenAPI 规范、MCP 定义、客户端 SDK）的痛点，显著提升开发效率。

主要特性

• 单一模式定义：在装饰器中定义 Zod 模式，自动同步到请求验证、OpenAPI 3.1 规范、MCP 工具和类型化客户端。
• AI 代理友好：提供明确的 API 契约，AI 编码代理可直接基于模式生成代码，避免产生不一致的端点。
• 基于 LoopBack 4：继承其成熟的依赖注入、控制器、拦截器等架构，同时针对 AI 场景优化。
• ESM 原生支持：完全采用 ES 模块，与现代 Node.js 生态无缝集成。
• 无代码生成：无需额外工具或构建步骤，类型化客户端直接从模式推导。

适用场景

AgentBack 特别适合需要同时提供 HTTP API 和 MCP 服务的 AI 应用开发，尤其是那些希望利用 AI 编码代理自动生成客户端代码的项目。它也适用于需要严格 API 契约的微服务架构，以及希望减少样板代码的 Node.js 后端开发。