← 返回目录

Butterbase

社区

AI 原生的开源后端即服务（BaaS），集成了 Postgres、身份认证、存储、函数、AI 网关和 MCP 服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 云存储第 10 / 15
Stars: ★ 3.7k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 22+ · Docker · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 5 天前

55FMRS · C

Butterbase 是一个功能丰富的开源 BaaS，提供强大的 MCP 服务器集成，适合开发者构建 AI 应用。其优势在于一体化后端服务，但开源版本较新，存在一定的稳定性风险，且部分高级功能仅面向托管用户。

最强项 · 维护活跃度 15/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

11/20

维护活跃度

15/20

文档质量

13/20

安装易用性

9/20

查看各项评分依据

可靠性 7/20: 证据：server manifest 结构完整，声明了 npm 包 @butterbase/mcp、stdio 传输、必需的 BUTTERBASE_API_KEY 环境变量以及 streamable-http 远程端点；README 描述了自托管栈的健康检查（/health/ready）和 curl 冒烟测试路径。扣分：本次仅审阅 README 与 manifest（均为不可信证据），未提供 MCP server 的实际源码、CI 工作流或提交的测试用例；工具清单、错误处理与边界行为无法核实；stdio 和 /mcp HTTP 两条路径都依赖 control-api 或托管服务，涉及三个 Postgres plane、Docker、Deno runtime 等大量组件，静态材料下故障难以受控诊断。按静态校准规则，缺少可验证的执行证据，可靠性不能高于 12，故给 7 分。
安全与权限 11/20: 证据：BUTTERBASE_API_KEY 在 manifest 中被标记为必需且机密，Authorization 头同样标记为必需和机密；项目具备行级安全（RLS）、审计日志、SECURITY.md 专用安全联系渠道；安装示例中未出现真实令牌或密钥。扣分：无法从源码核实宽泛工具面（auth、storage、functions、deploys、RAG）的最小权限划分；危险/远程命令类操作（删除、部署、函数执行）是否有二次确认不可验证；本地开发配置 AUTH_ENABLED=false 完全关闭认证，自托管用户若误留此配置存在风险；托管端点的数据流披露仅停留在 manifest 层面。未触发任何红线，故分数保持在 4 分以上，但权限与确认机制证据不足，给 11 分。
维护活跃度 15/20: 证据：Apache-2.0 许可证、明确版权主体（NetGPT Inc.）、SECURITY.md 及专用安全联系邮箱（[email protected]）、CHANGELOG（最新 v0.2.0，2026-05-25 发布）、ROADMAP、CONTRIBUTING.md；仓库未被归档且开放 issue 数量少（5 个）；README 显示按版本迭代（v0.2.0 新增 KV store 并覆盖 SDK/REST/CLI/MCP）。扣分：提交频率与 issue 响应速度无法从本次提供的材料核实；README 自述 OSS 发行版仍属早期；star 数仅作为发现信号，不计入分数。治理、许可证和更新路径较清晰，但持续活跃度缺乏可验证证据，给 15 分。
文档质量 13/20: 证据：README 覆盖面广，包含功能列表、自托管快速开始（6 步）、本地端点表、架构图、仓库结构表、docs 目录、SETUP.md、runbooks、Examples 和故障排查提示（如首次构建耗时、迁移不自动执行、全新卷需 seed）；manifest 记录了环境变量格式（bb_sk_...）、远程 URL 和必需请求头。扣分：未提供各 MCP 工具的参数文档或工具清单；托管端点没有限额/费用披露；MCP 专属排障内容仅引用 SETUP.md，其实际内容不在本次审阅范围内，文档的'可审阅证据'不完整，故给 13 分。
安装易用性 9/20: 证据：两条接入路径均有说明——托管方式（stdio 的 npx @butterbase/mcp 或 streamable-http 的 https://api.butterbase.ai/mcp）只需设置 BUTTERBASE_API_KEY；自托管路径有分步快速开始（clone 含 submodule、npm ci、docker compose、健康检查、迁移、seed、冒烟测试），并注明 Node 22+ 与 Docker 要求。扣分：自托管步骤多且存在多处已记载的坑（普通 clone 静默跳过 submodule 导致 workspace 缺失、schema 不会自动迁移、全新卷需手动 seed、开发模式关闭认证）；没有给出任何主流 MCP 客户端（如 Claude Desktop）的配置示例；材料中无 CI/测试证据，按静态校准 setup 不能高于 15；整体复杂度偏高、偏手工，给 9 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络修改第三方账户数据连接数据库

适合谁

开发者构建 AI 原生应用
需要自托管 BaaS 的团队
希望将后端能力暴露给 AI 代理的项目

不适合谁

需要完全托管服务的非技术用户
对稳定性和生产支持要求极高的企业
对后端服务需求简单、仅需单一功能的场景

所需权限

需要 BUTTERBASE_API_KEY（bb_sk_...）以访问 API
如果自托管，需要 Docker、Node.js 22+ 环境
可能需要配置数据库、Redis、S3/R2 等基础设施

风险与副作用

开源版本较新（v0.2.0），可能存在未发现的 bug
某些功能（如多区域编排、计费）仅在托管的私有仓库中提供，自托管时功能受限
AI 网关缺少上游路由适配器，需要自己实现

安装接入

准备工作

运行环境：Node.js 22+ · Docker · 远程托管（无需本地环境）

BUTTERBASE_API_KEY 必填密钥 Butterbase API 密钥（格式 bb_sk_...），用于 stdio 和远程端点的认证；可在 https://butterbase.ai 创建。

克隆仓库（包含子模块）：git clone --recurse-submodules https://github.com/butterbase-ai/butterbase.git
安装依赖：npm ci
复制环境变量：cp .env.example .env
启动服务：docker compose -f docker-compose.local.yml up -d
运行数据库迁移：按要求设置环境变量后执行 npm run migrate:all
初始化开发用户：npm run seed:dev

（MCP 服务器可通过 npm 包 @butterbase/mcp 或 HTTP 端点 https://api.butterbase.ai/mcp 使用）

claude_desktop_config.json

{
  "mcpServers": {
    "butterbase": {
      "command": "npx",
      "args": [
        "-y",
        "@butterbase/mcp"
      ],
      "env": {
        "BUTTERBASE_API_KEY": "bb_sk_..."
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "butterbase": {
      "command": "npx",
      "args": [
        "-y",
        "@butterbase/mcp"
      ],
      "env": {
        "BUTTERBASE_API_KEY": "bb_sk_..."
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add butterbase -e BUTTERBASE_API_KEY=bb_sk_... -- npx -y @butterbase/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置中添加该服务器并填入 BUTTERBASE_API_KEY 后，工具列表应出现用于管理 schemas、auth、functions、storage、RAG 和 deploys 的 Butterbase MCP 工具。

常见排障

检查 API key 是否正确设置
确认服务已启动并运行（控制 API 健康检查）
查看 Docker 日志和 Postgres 连接状态
确保数据库迁移已正确执行

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我在 Butterbase 后端创建一个带 RLS 策略的 todos 表
列出我应用的所有存储桶并生成一个文件的预签名 URL
把我的函数部署到 Butterbase 并触发一次测试调用
在我的 RAG 集合中做一次语义搜索并生成答案

使用场景

构建 AI 驱动的应用，后端服务快速搭建

为 AI 代理提供后端管理接口

快速开发、测试和部署后端功能

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Butterbase 是一个开源的、AI 原生的后端即服务平台，提供丰富的后端能力：Postgres 数据平面（含行级安全）、无服务器函数、LLM 网关、实时订阅、键值存储、文件存储、RAG、持久化按键 Actor 以及内置的 MCP 服务器，使 AI 代理能够通过工具而非胶水代码来操作你的后端。支持自托管和管理两种模式。