用自然语言就能让 AI 帮你写全栈应用？InsForge 入门与实践全记录

“我只想告诉 AI ‘做一个带登录的待办清单’，后端、数据库、文件存储就全部自动完成。”
如果你也有同样的愿望，本文会把 InsForge 从安装到上线的全过程拆开揉碎讲给你听。

目录

  1. InsForge 到底是什么？
  2. 它能帮你做什么？
  3. 三步完成本地安装
  4. 把 Claude、GPT 等 AI 接到 InsForge
  5. 用一句话生成待办清单、Instagram 克隆等真实项目
  6. 架构速览：为什么 AI 能直接“看懂”你的后端
  7. 常见疑问一次说清（FAQ）
  8. 下一步阅读与社区支持

1. InsForge 是什么？

一句话概括：InsForge 是面向 AI Agent 的 Supabase 替代方案。
它把传统后端拆成四大能力：登录、数据库、文件存储、即将上线的函数与部署，再用 MCP 协议暴露给任何大语言模型。
结果就是——你不再需要写后端代码，只需要在聊天框里用中文或英文描述需求，AI 会自动调用 InsForge 的接口完成剩余工作。

知识图谱速查

  • Supabase：开源 Firebase 替代，提供 Postgres 数据库、身份验证、实时订阅等。
  • AI Agent：能调用外部工具的大语言模型，例如 Claude、GPT-4o。
  • MCP（Model-Context Protocol）：让 AI 像插件一样调用外部服务的协议，类似浏览器的扩展系统。

2. 它能帮你做什么？

功能 你能得到什么 典型场景
用户认证 邮箱、社交登录、权限体系 做一个“注册/登录”按钮即可用
数据库 Postgres 风格的表、SQL、REST API 让 AI 直接建表、写查询
文件存储 上传、下载、CDN 链接 用户头像、商品图片秒传
函数（即将上线） 无服务器计算 写一段 Python/Node 逻辑，AI 帮你部署
站点部署（即将上线） 一键上线域名 把前端打包丢给 InsForge 就行

3. 三步完成本地安装

前提：电脑已装好 Docker 与 Node.js。
如果你已经跑过 Postgres 或 Supabase，这一步只需要 3 分钟。

步骤 1：克隆仓库

git clone https://github.com/insforge/insforge.git
cd insforge

步骤 2：准备环境变量

cp .env.docker.example .env

默认配置即可跑起来，真正上线时再改端口、密钥。

步骤 3：启动容器

docker compose up

看到终端提示 insforge-db | ready to accept connections 就说明后端已就绪。
浏览器打开 http://localhost:7131 即可看到登录界面。

Sign in to InsForge

4. 把 Claude、GPT 等 AI 接到 InsForge

4.1 在 InsForge 里启用 MCP

登录后，侧边栏会出现 “Get Started” 向导，点进去会看到 MCP 配置页。
复制形如 mcp://localhost:7131/mcp 的地址，后面会用到。

Configure MCP connection

4.2 在 AI 里配置 MCP（以 Claude Desktop 为例）

  1. 打开 Claude Desktop → Settings → MCP Servers
  2. 新增一条：

    • Name: insforge
    • URL: 刚才复制的地址
  3. 保存后重启 Claude。

4.3 测试连接

在对话框输入：

InsForge is my backend platform, what is my current backend structure?

如果返回类似下图，说明 AI 已经能调用 InsForge 的工具。

Successful Connection Response

5. 用一句话生成真实项目

5.1 标准起手式

新建一个空文件夹，在 AI 对话框里输入：

Learn how to use InsForge

AI 会告诉你它已掌握以下工具：

  • 创建表（CreateTable）
  • 插入数据（InsertRow）
  • 上传文件（UploadFile）
  • 查询（Query）

5.2 项目 1：待办清单 + 登录

Prompt

Build a todo app with user authentication

AI 会连续执行：

  1. 创建 users 表（id, email, password_hash）
  2. 创建 todos 表（id, user_id, title, done）
  3. 生成注册 / 登录接口
  4. 返回前端可直接调用的 REST 路径

你只需把返回的代码粘到 Lovable、Bolt 或其他 AI 前端工具，界面瞬间可用。

5.3 项目 2：Instagram 克隆

Prompt

Create an Instagram with image upload

AI 会：

  1. 建用户表
  2. 建帖子表（含 image_url 字段）
  3. 调用 InsForge 的 UploadFile 工具自动把图片存到 CDN
  4. 返回实时可访问的 URL

6. 架构速览：为什么 AI 能直接“看懂”你的后端

下图是官方提供的架构图，一句话解释：所有功能都通过 MCP 暴露成“工具”，AI 像调用函数一样调用它们。

Architecture Diagram
层级 作用 你看到的
Postgres 层 数据持久化 自动建表、索引
Storage 层 文件对象存储 上传后拿到 CDN 链接
Auth 层 JWT、会话 登录按钮直接可用
MCP 网关 把以上能力转成 JSON Schema AI 可直接理解
AI Agent 用自然语言调用网关 你聊天即可

7. FAQ：你可能想问的 12 个问题

7.1 安装相关

Q1：Docker 启动失败怎么办？
A：检查 5432、7131 端口是否被占用；若被占用，改 .env 里的端口再重启。

Q2：Windows 能用吗？
A：可以，只要 Docker Desktop 正常运行即可，步骤完全一致。

Q3：需要单独装 Postgres 吗？
A：不需要，Docker Compose 已经打包了官方 Postgres 容器。

7.2 使用相关

Q4：AI 会不会误删我的数据？
A：所有工具都运行在沙箱权限内，默认只有当前项目可见；正式环境建议开只读副本。

Q5：如何给表加索引？
A：直接告诉 AI “给 todos 表的 user_id 加索引”，它会执行 SQL 并返回结果。

Q6：上传的文件有大小限制吗？
A：目前单文件 100 MB，后续版本可通过环境变量调节。

Q7：如何自定义认证方式，比如手机号登录？
A：在 InsForge Dashboard → Authentication → Providers 里启用相应选项，AI 会实时读取配置。

Q8：支持多语言吗？
A：数据库层使用 UTF-8，AI 支持中英双语，其他语言只要模型支持即可。

Q9：如何备份？
A：使用 docker exec 进入 Postgres 容器，执行 pg_dump；官方脚本即将上线。

7.3 未来功能

Q10：Serverless Functions 什么时候发布？
A：官方路线图显示 2024 Q4 上线，支持 Python、Node、Go。

Q11：能一键部署到 Vercel/Netlify 吗？
A：站点部署功能发布后即可，只需在 AI 中输入 “deploy to Vercel”。

Q12：收费模式？
A：本地版永久免费，云端托管版按量计费，具体价格待官方公布。

8. 下一步阅读与社区支持

  • 官方文档：正在编写，预计覆盖认证、数据库、存储全部细节。
  • Discord 社区：

    • 链接：https://discord.gg/MPxwj5xVvW
    • 频道 #show-and-tell 可分享你用 InsForge 做的项目。

现在，打开终端，复制那三行命令，十分钟后你就能对 AI 说：
“帮我做一个带登录的在线简历网站。”
剩下的，交给 InsForge。