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 InsForge/How it works/Core Products;GitHub desc,license Apache-2.0 查看 GitHub 仓库 →

为什么值得关注

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

来源:GitHub 10,478 stars / 882 forks,created 2025-07-29;README How it works

核心功能

面向 agent 的两种操作接口

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

来源:README How it works(MCP Server / CLI + Skills)
agent 可读的后端上下文与状态

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

来源:README How it works(Read backend context and state)
一体化后端原语

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

来源:README Core Products;tree(functions/Deno、backend/、packages/)
agent 直接配置后端资源

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

来源:README How it works(Configure primitives)
云托管或一键自托管

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

来源:README Quickstart(Cloud/Self-hosted/Multiple Projects/One-click Deployment)

技术架构

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 接口层 + 边缘函数运行时」的组合,工程化与可自托管性都比较完整。

来源:tree(backend/frontend/functions/packages、docker-compose.*、.claude-plugin/.codex);package.json workspaces

项目知识图谱

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

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript (后端/前端) + Deno (边缘函数)框架自研 BaaS 后端 + Vite 前端 + MCP
PostgreSQL (数据库)S3 兼容存储Deno (边缘函数)MCP (agent 接口)OpenAI 兼容模型网关Vite (管理面板)Docker Compose (自托管)
云托管 insforge.dev 或 Docker Compose 自托管(默认 7130);支持同主机多项目与一键部署
来源:README Core Products/Quickstart;tree(functions/deno.json、backend、frontend/vite.config.ts)

快速上手

云版直接用 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 Quickstart(Self-hosted/Connect MCP/Verify/Multiple Projects)

使用场景

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

来源:README 定位/How it works,结合定位推断

优势与局限

优势

  • 切入点准:把后端原语统一成 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 Core Products/Quickstart;tree;版本与预览状态推断

最新版本

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

来源:GitHub Releases v2.1.7~v2.1.5;created 2025-07-29;pushed_at 2026-05-22

总结评价

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

来源:综合 README 定位/能力、tree 工程结构、版本与预览状态的事实判断

常见问题

InsForge 是什么?

InsForge 是一个开源的、为「agentic coding(让 AI 编码 agent 自己干活)」设计的一体化后端平台——可以理解成「面向 AI agent 的 Supabase」。

InsForge 有哪些核心功能?

InsForge 的核心功能包括:面向 agent 的两种操作接口、agent 可读的后端上下文与状态、一体化后端原语、agent 直接配置后端资源、云托管或一键自托管。

InsForge 为什么最近很受关注?

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

InsForge 适合哪些使用场景?

适合:①用 Claude Code/Cursor/Codex 等 agent 做全栈开发、希望 agent 自己把数据库/认证/存储/函数/部署配起来而非只写前端的人;②想要 Supabase 式一体化后端、但要 agent 原生(MCP/CLI 可操作)的开发者与独立开发者;③想自托管、数据自控的团队。

透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 20:25. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件