Butterbase Ai

io.github.butterbase-ai由 GitHub 账号 butterbase-ai 发布v1.0.0更新于 Oct 24, 2026

Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys.

已验证Streamable HTTP可网页运行数据库云端与基础设施开发者工具

概览

AI 生成的概览

Butterbase 官方 MCP 服务器，让助手管理 Butterbase 后端：数据库结构、认证、函数、存储、RAG、前端与部署。

可以做什么
  • 创建、配置、迁移、克隆和删除应用、区域与环境变量
  • 管理数据库结构与迁移，查询、插入和填充数据行
  • 配置认证、用户、OAuth、人员与行级安全策略
  • 部署和调用函数，管理存储、KV、实时功能与持久对象
  • 部署前端与预览，管理 RAG 内容并执行 RAG 查询
  • 管理 AI 网关与智能体、代码仓库、集成、账单、API 密钥与审计日志
适用场景
适合在 Butterbase 上构建或运维应用时，让助手直接在聊天客户端完成后端配置与变更，而不必打开控制台。也适合希望以对话方式处理结构、认证、函数和部署工作的团队。
运行要求
需要 Butterbase 账号和 API 密钥（bb_sk_...），通过环境变量 BUTTERBASE_API_KEY 提供，或对托管端点使用 Authorization bearer 头。可本地通过 npx @butterbase/mcp 运行，也可连接远程 streamable HTTP 端点；声明要求 OAuth。需要访问 Butterbase 的网络。
安装前请注意
该 API 密钥拥有广泛的后端控制权限，应作为机密保管，避免写入共享配置。许多工具会写入、部署、暂停、克隆或删除资源，包括应用、结构、函数、存储和 API 密钥，账单与集成工具还可能产生费用。可选的 Office 功能需要显式提供 org_id，并返回确认回执，须由人类负责人在浏览器中核对。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Butterbase Ai，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.butterbase-ai%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "butterbase-ai": {
      "type": "http",
      "url": "https://api.butterbase.ai/mcp"
    }
  }
}

README

@butterbase/mcp

The official Model Context Protocol server for Butterbase — manage schemas, auth, functions, storage, RAG, realtime, and deploys on Butterbase from any MCP-capable client (Claude Code, Claude Desktop, Cursor, Windsurf, etc.).

Install

bash
npx @butterbase/mcp

Or install globally:

bash
npm install -g @butterbase/mcpbutterbase-mcp

Configure

Add to your MCP client config (.mcp.json, claude_desktop_config.json, etc.):

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

Get an API key at butterbase.ai.

Hosted alternative

Prefer to skip the local install? Butterbase also runs a hosted MCP endpoint:

json
{  "mcpServers": {    "butterbase": {      "url": "https://api.butterbase.ai/mcp",      "headers": {        "Authorization": "Bearer ${BUTTERBASE_API_KEY}"      }    }  }}

What you can do

The available tools depend on the server's enabled capabilities, including:

  • Apps & regions — init_app, manage_app (actions: list/delete/pause/get_config/update_access_mode/secure/update_cors/set_visibility/preview_clone_env_vars/clone/get_clone_job/find_templates/set_clone_webhook/link_substrate/unlink_substrate/set_substrate_autopropagate/move/move_status/teardown_source_replica/get_env/update_env/publish_template_release/list_template_releases/get_template_release/check_template_updates/update_from_template), list_regions
  • Schema — manage_schema, manage_migrations
  • Auth — manage_auth_config, manage_auth_users, manage_oauth, manage_people
  • Data — select_rows, insert_row, seed_database
  • Functions — deploy_function, invoke_function, manage_function
  • Storage & KV — manage_storage, manage_kv
  • Frontends & previews — create_frontend_deployment, manage_frontend, manage_edge_ssr, manage_preview, promote_preview
  • RAG — manage_rag_content, rag_query
  • Realtime & Durable Objects — manage_realtime, manage_durable_objects
  • AI gateway & agents — manage_ai, manage_agents
  • RLS — manage_rls
  • Repo — manage_repo
  • Integrations & billing — manage_integrations, list_partner_apis, manage_billing
  • API keys & audit logs — manage_api_keys, query_audit_logs
  • Docs, suggestions & hackathons — butterbase_docs, submit_suggestion, prep_and_submit_hackathon_entry
  • Office (optional cloud capability) — manage_office provides 44 organization-scoped actions for Ask, conversations, decisions, lifecycle controls, business records, curated agent memory, routines, cadence and paginated records. Read butterbase_docs with topic: "office" first. Every call needs an explicit org_id and platform credential; no app is selected. Enable/pause/resume/approve return confirmation receipts for the initiating owner to review in the browser. Agents must show the URL and observe the outcome, never confirm it themselves. OSS-only installations may omit this tool. See the Office client reference.

See the Butterbase docs for the full list.

License

Apache-2.0 © NetGPT Inc.

来源：services/mcp-server/README.md，提交 473c69b

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分