介绍
one-api 是一个 AI native 数据库——一键启动后,同一个 SQLite 业务库可以被四种前端消费:HTTP REST API、管理界面、MCP 服务、CLI。
它的目标不是再造一个数据库,而是给数据「开四扇门」:定义一次模型,业务库同时被人类(管理界面)、程序(HTTP API / SDK)、AI(MCP)、终端(CLI)读写,无需为每种消费方式各写一套后端。
为什么
传统方案里,给一个 SQLite 库配上「能被外部访问的 API + 管理后台 + AI 能调用的接口 + 命令行工具」往往要拼凑好几个项目。one-api 把这些统一成单进程一键启动的能力:
pnpm start一个进程,同时提供/api/*数据接口与/admin管理界面;/mcp端点让 AI agent 直接读写数据、甚至自主建表;one-api-cli在终端完成同样的操作,还能本地直连 SQLite 文件。
这一切都建立在同一个元数据驱动的引擎之上——table_meta 存了每张表的字段定义,引擎据此动态生成 CRUD 与校验。
灵感来源
one-api 受 SimpleCURD 启发:用最少配置把 SQLite 变成可被消费的数据服务。在此之上,one-api 引入了类型映射(SQLite ↔ JSONSchema ↔ Zod)、Token 权限模型与 MCP 集成,使其成为 AI 时代的「数据即接口」底座。
核心特性
- 元数据驱动:导入已有 SQLite 表或新建模型,引擎据此生成 CRUD,管理界面据此渲染表单。
- 四前端消费:同一份业务数据,四种访问方式,无需各写后端。
- 单进程一键启动:后端内置前端静态文件,
pnpm start即用,部署零依赖(仅 SQLite)。 - 类型映射:SQLite ↔ JSONSchema ↔ Zod 一处定义、三处消费,前后端共享同一套类型(
@1api/shared)。 - AI native:内置 MCP 服务(Streamable HTTP),AI agent 可直接读写数据、自主建表,无需手写集成层。
- 动态 SQL 安全:标识符包裹 + 值参数化 + 字段白名单,杜绝 SQL 注入。
它适合谁
- 想快速给 SQLite 数据配一套 API + 后台的独立开发者;
- 需要让 AI agent 直接操作业务数据的应用团队;
- 在做原型 / 内部工具,不想为每个数据源都搭后端的人。
准备好了?继续看 快速上手,5 分钟跑通。