InsForge 是什么?

InsForge 是一个开源的、为「agentic coding(让 AI 编码 agent 自己干活)」设计的一体化后端平台——可以理解成「面向 AI agent 的 Supabase」。它把数据库(Postgres)、认证、存储(S3 兼容)、边缘函数、模型网关(OpenAI 兼容、跨多家 LLM)、计算(容器服务,私有预览)和站点部署打包成一套后端,让编码 agent 像后端工程师一样读取后端上下文(schema、metadata、日志)并配置这些资源,从而端到端交付全栈应用。agent 通过 MCP Server(自托管+云)或 CLI+Skills(仅云)两种接口操作它。TypeScript、Apache-2.0,可云托管(insforge.dev)或 Docker 自托管。

⭐ 11,857 Stars 🍴 1,009 Forks TypeScript Apache-2.0 作者: InsForge 商业引流:中
来源:官方 README 与文档入口 查看 GitHub 仓库 →

为什么值得关注

约 1.05 万星、882 fork,热度来自一个清晰的趋势判断:当编码 agent 越来越能写前端和业务逻辑后,瓶颈转移到「后端怎么自动配起来」——数据库、认证、存储、函数、部署这些 agent 过去搞不定。InsForge 把这些后端原语统一成 agent 可经 MCP/CLI 直接操作的接口,正好补上『agent 写全栈应用的最后一块后端拼图』,加上 Supabase 式的熟悉心智 + 自托管开源,吸引力很强。

来源:官方 README 与文档入口

核心功能

面向 agent 的两种操作接口

MCP Server(自托管与云均可)把 InsForge 的操作暴露为 MCP 工具供任意兼容 agent 调用;CLI + Skills(仅云)让 agent 从终端直接调用。两者都让 agent 能读后端上下文/状态并配置后端原语。

来源:官方 README 与文档入口
agent 可读的后端上下文与状态

agent 可拉取文档、schema、metadata(已部署函数、bucket 内容、auth 配置)和运行时日志,从而有足够信息写代码、验证产物、出错时调试——把后端从黑盒变成 agent 可观测可操作的对象。

来源:官方 README 与文档入口
一体化后端原语

认证(用户/会话管理)、Postgres 关系数据库、S3 兼容存储、边缘函数(Deno serverless)、模型网关(OpenAI 兼容、跨多家 LLM provider)、计算(长运行容器服务,私有预览)、站点构建与部署,覆盖全栈应用所需后端。

来源:官方 README 与文档入口
agent 直接配置后端资源

agent 可直接部署边缘函数、跑数据库 migration、创建存储 bucket、配置 auth provider 等,像后端工程师一样操作平台,而不是只生成代码让人去点。

来源:官方 README 与文档入口
云托管或一键自托管

可用云版 insforge.dev,或用 Docker Compose 自托管(docker-compose.prod.yml 起本地实例,默认 7130 端口连 MCP),支持同主机多项目(不同端口+env),并提供一键部署模板。

来源:官方 README 与文档入口

技术架构

npm workspaces monorepo(包名 insforge)。backend/ 是 TypeScript 后端核心(src/ + tests,tsup 构建、vitest 测试),承载认证、数据库、存储、模型网关等服务并对外暴露 REST/OpenAPI 与 MCP;frontend/ 是 Vite SPA 管理面板(连 MCP、看资源状态);functions/ 是基于 Deno 的边缘函数运行时(server.ts + worker-template.js + 示例);packages/ 下有 dashboard、shared-schemas(前后端共享类型)、ui 等可复用包。数据层用 Postgres,存储 S3 兼容。仓库内置 .claude-plugin、.codex、.agents、.gstack 等多种 agent 集成配置,并有 docker-compose 多套(dev/prod/override/dokploy)支撑自托管与一键部署。整体是「Supabase 式 BaaS 后端 + 面向 agent 的 MCP/CLI 接口层 + 边缘函数运行时」的组合,工程化与可自托管性都比较完整。

来源:官方仓库

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) PostgreSQL (数据库)PostgreSQL S3 兼容存储 Deno (边缘函数)Deno MCP (agent 接口)MCP OpenAI 兼容模型网关OpenAI 兼容模型… 面向 agent 的两种操作接口面向 agent 的两种操作… agent 可读的后端上下文与状态agent 可读的后端上下… 一体化后端原语 agent 直接配置后端资源 云托管或一键自托管 InsForge 项目本体 核心功能 关键依赖

技术栈

语言TypeScript (后端/前端) + Deno (边缘函数)框架自研 BaaS 后端 + Vite 前端 + MCP
PostgreSQL (数据库)S3 兼容存储Deno (边缘函数)MCP (agent 接口)OpenAI 兼容模型网关Vite (管理面板)Docker Compose (自托管)
云托管 insforge.dev 或 Docker Compose 自托管(默认 7130);支持同主机多项目与一键部署
来源:官方 README 与文档入口

快速上手

云版直接用 insforge.dev。自托管:装 Docker + Node.js,`git clone https://github.com/InsForge/InsForge.git && cd insforge && cp .env.example .env && docker compose -f docker-compose.prod.yml up`,打开 http://localhost:7130 按引导连接 InsForge MCP Server。验证:给 agent 发「I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions.」。同主机多项目用不同端口和独立 .env。也提供一键部署模板。
来源:官方 README 与文档入口

使用场景

适合:①用 Claude Code/Cursor/Codex 等 agent 做全栈开发、希望 agent 自己把数据库/认证/存储/函数/部署配起来而非只写前端的人;②想要 Supabase 式一体化后端、但要 agent 原生(MCP/CLI 可操作)的开发者与独立开发者;③想自托管、数据自控的团队。不适合:需要成熟稳定生产 BaaS、对 SLA/合规要求高的团队(仍在 2.x 早期、计算等能力还在私有预览);以及不使用编码 agent、只想要传统手动后端的人。

来源:官方 README 与文档入口

优势与局限

优势

  • 切入点准:把后端原语统一成 agent 可经 MCP/CLI 操作的对象,补上 agent 写全栈应用的后端短板
  • 一体化且开源:数据库/认证/存储/函数/模型网关/部署齐全,Apache-2.0、可自托管、数据自控
  • agent 可观测后端:能读 schema/metadata/日志再写代码和调试,而非盲改,契合 agent 工作方式
  • 心智熟悉:Supabase 式 BaaS + 模型网关,迁移与上手成本低,并内置多种 agent 集成配置
  • 工程完整:monorepo、Deno 边缘函数、多套 docker-compose、OpenAPI,自托管与一键部署都顾到

局限

  • 成熟度仍早期(2.x),Compute 等核心能力还在私有预览,生产可靠性待验证
  • 自托管要起 Postgres/存储/函数等多组件,运维有一定门槛,全功能(如云端 CLI+Skills)部分仅云版可用
  • 让 agent 直接操作生产后端(建库、改 migration、配 auth)权限大,存在 agent 误操作/数据风险,需谨慎授权
  • 作为一体化平台存在锁定感,迁出与可移植性需评估
  • 模型网关/部署等能力的成本与上游依赖(LLM provider、托管资源)由使用者承担
来源:官方 README 与文档入口

最新版本

采用语义化版本,最新为 v2.1.7(2026-05-21),近期连发 v2.1.6/v2.1.5(2026-05 中旬),发布频繁;仓库创建于 2025-07,迭代到 2.x,主分支持续高频提交(最近 push 2026-05-22),是相对成型但仍快速演进的项目。

来源:官方 Releases

总结评价

InsForge 抓住了 agent 编程的一个真瓶颈:agent 越来越会写前端和逻辑,但后端(数据库、认证、存储、函数、部署)一直是它搞不定的黑盒。它的做法很对路——把这些后端原语统一成 agent 能经 MCP/CLI 读状态、配资源的对象,做成一个 Supabase 式、可自托管的一体化平台,1 万星说明需求真实。要清醒的是它仍在 2.x 早期、Compute 等还在预览、让 agent 直接操作生产后端权限很大、自托管也有运维门槛。对想让 agent 端到端交付全栈应用、又能接受自托管和早期成熟度的开发者,这是目前最值得关注的『agent 原生后端』之一;要稳定生产 BaaS 的团队则需谨慎评估。

来源:官方 README 与文档入口
资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-05-22 20:25.

参考材料:README、GitHub API、依赖文件