Butterbase 工具链清单：SDK、CLI 与 Claude Code 插件的 AI 辅助开发完整指南

Butterbase 工具链清单SDK、CLI 与 Claude Code 插件的 AI 辅助开发完整指南【免费下载链接】butterbase-ossOpen-source backend-as-a-service. Postgres, auth, storage, functions, AI gateway, MCP.项目地址: https://gitcode.com/gh_mirrors/bu/butterbase-ossButterbase 工具链是开源 BaaS后端即服务项目 Butterbase 的三大核心开发利器butterbase/sdkTypeScript SDK、butterbase/cli命令行工具和 Claude Code 插件30 引导式 Skills三者配合 MCP 协议让你用自然语言即可完成 Postgres 数据库、认证、存储、无服务器函数与 AI 网关的全部后端搭建。本文面向新手带你快速上手这套 AI 辅助开发工具链。一图看懂Butterbase 三大工具各司其职 工具定位适合场景源码位置butterbase/sdk通用 TypeScript 客户端前端/后端代码中读写数据、认证、上传文件packages/sdk/butterbase/clibutterbase命令行工具脚手架、部署函数、管理 schema/存储/AI 配置packages/cli/butterbase/pluginClaude Code 插件30 SkillsAI 对话式搭建完整应用想法 → 上线packages/plugin/butterbase/mcpMCP 服务器让任何 AI 客户端用 40 工具直接操作后端services/mcp-server/简单记法SDK 管代码里用CLI 管终端里管插件 MCP 管让 AI 替你干。butterbase/sdk前端后端通用的 TypeScript 客户端 SDK 可在浏览器、Node.js 和 Deno 三种环境运行是官方文档中所有示例代码的基础。30 秒上手 SDK安装、初始化与查询数据安装后只需三步初始化客户端 → 查询 → 写入。import { createClient } from butterbase/sdk; const bb createClient({ appId: app_abc123, apiUrl: https://api.butterbase.ai }); // 查询链式查询构建器类似 SQL 的 where/order/limit const { data, error } await bb.from(posts).select(*).eq(status, published); // 写入 await bb.from(posts).insert({ title: Hello, content: ... });除了数据 CRUDSDK 还内置了以下能力详见 packages/sdk/README.md认证auth.signUp/signIn/ OAuth 登录会话自动持久化到 localStorage令牌自动刷新文件存储storage.upload/getDownloadUrl/delete函数调用functions.invoke直接触发云端无服务器函数RAG 检索、实时订阅、AI 网关chat / embeddings类型安全fromPost(posts)可传入泛型返回数据自动推断类型。 错误处理同样对 AI 友好所有方法返回{ data, error }error是带code、remediation修复建议的强类型错误对象方便 AI Agent 自我纠错。butterbase/cli一行命令搞定脚手架与部署 CLI 把建应用、改表结构、发函数、传文件、配 AI这些重复操作全部变成一条命令。CLI 一键安装与登录步骤npm install -g butterbase/cli # 1. 安装 butterbase login # 2. 用 API Key 登录 butterbase init # 3. 生成本地项目内置 React Vite 模板butterbase init会基于 packages/cli/templates/react-vite/ 模板自动替换 App ID、API 地址等变量并生成.mcp.json供 Claude Code 直接接入见 packages/cli/src/commands/init.ts。常用命令清单schema、functions、storage 与 AI任务命令拉取/应用数据库结构butterbase schema get/schema apply schema.json部署无服务器函数butterbase functions deploy ./functions/hello.ts上传文件到存储butterbase storage upload ./image.png命令行对话 AIbutterbase ai chat ... --model openai/gpt-4o-mini生成带权限的 API Keybutterbase keys generate ci-key --scope schema:read配置 OAuth 登录butterbase oauth configure google ...接入 MCPbutterbase mcp install自动写入 14 种 AI 客户端配置配置保存在~/.butterbase/config.json全局和.butterbase/config.json项目级也支持BUTTERBASE_API_KEY、BUTTERBASE_ENDPOINT环境变量。完整命令参考 packages/cli/README.md各子命令实现位于 packages/cli/src/commands/。Claude Code 插件与 MCP让 AI 直接操作后端 这是 Butterbase 最AI 原生的部分——内置的 MCP 服务器把平台能力暴露为 40 个工具manage_schema声明式建表 dry-run 预览、deploy_function、manage_rls、manage_auth_config、rag_query等。AI 不再需要拼胶水代码而是调用工具完成操作。3 种接入 MCP 的方式托管、本地 stdio 与插件托管端点最省事在任意 MCP 客户端配置中填入https://api.butterbase.ai/mcp Bearer 认证头即可本地 stdionpx butterbase/mcp零部署CLI 一键接入butterbase mcp install通过 add-mcp 自动写入 Claude Code、Cursor、VS Code 等 14 种客户端的配置并打印每种客户端的一次性浏览器登录指引实现见 packages/cli/src/commands/mcp.ts。支持 OAuth 2.1 授权流程已实测兼容Claude Code、Claude Desktop、Cursor、Windsurf、Codex CLI等主流 AI 客户端。30 引导式 Skills从想法到上线Claude Code 插件位于 packages/plugin/以 git submodule 形式挂载git clone时记得加--recurse-submodules否则该目录为空。它提供/butterbase-skills:journey、/butterbase-skills:build-app等 30 引导式技能覆盖完整链路想法 → 规划 → 建表schema→ 认证auth→ 函数functions→ 部署deploy→ 提交配合butterbase clone命令还可以一键克隆 templates/butterbaseCRM/、templates/butterSupport/ 等生产级模板应用从第一天就拥有可用的产品schema、RLS、函数、AI 配置全部随克隆带走。实战SDK CLI MCP 的推荐组合拳 ⚡一个典型的 AI 辅助开发流程长这样CLI 打地基butterbase login→butterbase apps create my-app→butterbase schema apply schema.jsonMCP 让 AI 接手butterbase mcp install接入 Claude Code用自然语言说给 posts 表加索引并配 RLS 策略AI 通过manage_schema、manage_rls工具直接执行并返回 dry-run 差异SDK 写业务前端用butterbase/sdk做登录、查询、上传验证与部署butterbase functions deploy ./functions/api.ts一键上线函数butterbase functions logs查看运行日志。目录结构与源码索引 模块相对路径说明SDK 源码packages/sdk/src/查询构建器、auth、storage、RAG、AI 等客户端CLI 源码packages/cli/src/init、mcp、plugin等全部子命令Claude Code 插件packages/plugin/30 引导式 SkillssubmoduleMCP 服务器services/mcp-server/40 工具实现技能说明SKILL.mdMCP 能力清单与 4 种安装方式示例应用Examples/todo-2026-04-02/最小完整示例前端 函数生产级模板templates/butterbaseCRM/29 张表 55 函数的 CRM 模板自托管指南SETUP.mdDocker 本地部署 数据库迁移 冒烟测试常见问题 FAQ ❓QAPI Key 从哪来自托管环境执行butterbase keys generate即可生成以bb_sk_开头也可在官方平台控制台创建然后export BUTTERBASE_API_KEYbb_sk_...。Q插件目录是空的怎么办packages/plugin是 git submodule普通git clone不会拉取内容需执行git submodule update --init --recursive补齐。QSDK 能在无服务器的 Deno 函数里用吗可以。import { createClient } from npm:butterbase/sdk配合Deno.env.get读取配置即可SDK 对浏览器/Node/Deno 三端全兼容。掌握SDK 写代码、CLI 管后端、Claude Code 插件 MCP 让 AI 干重活这套组合你就能以接近聊天的速度交付完整的全栈应用 【免费下载链接】butterbase-ossOpen-source backend-as-a-service. Postgres, auth, storage, functions, AI gateway, MCP.项目地址: https://gitcode.com/gh_mirrors/bu/butterbase-oss创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考