ButterBase 是 AI Skill Hub 本期精选MCP工具之一。已获得 1.0k 颗 GitHub Star，综合评分 8.0 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。
ButterBase 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
ButterBase 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/butterbase-ai/butterbase-oss
# 方式二：手动配置 claude_desktop_config.json
{
"mcpServers": {
"butterbase": {
"command": "npx",
"args": ["-y", "butterbase-oss"]
}
}
}
# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
# 安装后在 Claude 对话中直接使用 # 示例： 用户: 请帮我用 ButterBase 执行以下任务... Claude: [自动调用 ButterBase MCP 工具处理请求] # 查看可用工具列表 # 在 Claude 中输入："列出所有可用的 MCP 工具"
// claude_desktop_config.json 配置示例
{
"mcpServers": {
"butterbase": {
"command": "npx",
"args": ["-y", "butterbase-oss"],
"env": {
// "API_KEY": "your-api-key-here"
}
}
}
}
// 保存后重启 Claude Desktop 生效
<p align="center"> <img src=".github/assets/logo.png" alt="Butterbase" width="420" /> </p>
<p align="center"><strong>AI-native, open-source backend-as-a-service.</strong><br/>Postgres · Auth · Storage · Functions · AI Gateway · MCP server</p>
<p align="center"> <a href="./LICENSE"><img alt="License: Apache 2.0" src="https://img.shields.io/badge/License-Apache_2.0-blue.svg"></a> <a href="https://github.com/butterbase-ai/butterbase-oss/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/butterbase-ai/butterbase-oss?style=social"></a> <a href="https://github.com/butterbase-ai/butterbase-oss/network/members"><img alt="GitHub forks" src="https://img.shields.io/github/forks/butterbase-ai/butterbase-oss?style=social"></a> <br/> <a href="https://github.com/butterbase-ai/butterbase-oss/issues"><img alt="GitHub issues" src="https://img.shields.io/github/issues/butterbase-ai/butterbase-oss"></a> <a href="https://github.com/butterbase-ai/butterbase-oss/commits/main"><img alt="Last commit" src="https://img.shields.io/github/last-commit/butterbase-ai/butterbase-oss"></a> <a href="https://github.com/butterbase-ai/butterbase-oss/releases"><img alt="Release" src="https://img.shields.io/github/v/release/butterbase-ai/butterbase-oss?include_prereleases&sort=semver"></a> <a href="https://discord.gg/eZ7PT68uP"><img alt="Discord" src="https://img.shields.io/discord/1495105159469207702?logo=discord&logoColor=white&label=Discord&color=5865F2"></a> <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white"> <img alt="Postgres" src="https://img.shields.io/badge/Postgres-336791?logo=postgresql&logoColor=white"> <img alt="Docker" src="https://img.shields.io/badge/Docker-2496ED?logo=docker&logoColor=white"> </p>
<p align="center"> <a href="https://butterbase.ai"><strong>Website</strong></a> · <a href="https://discord.gg/eZ7PT68uP"><strong>Discord</strong></a> · <a href="./SETUP.md"><strong>Self-host</strong></a> · <a href="./docs"><strong>Docs</strong></a> · <a href="./ROADMAP.md"><strong>Roadmap</strong></a> · <a href="./Examples"><strong>Examples</strong></a> · <a href="./CONTRIBUTING.md"><strong>Contributing</strong></a> </p>
---
Butterbase gives you the building blocks for AI-driven applications without lock-in: a Postgres-backed backend with row-level security, serverless functions, an LLM gateway, realtime subscriptions, key-value store, file storage, RAG, durable per-key actors, and a built-in Model Context Protocol (MCP) server so agents can operate your backend with tools instead of glue code.
Data - Postgres data plane — per-app databases with declarative schema (/schema), automatic REST endpoints (/auto-api), and migrations. - Row-Level Security — first-class RLS policy management with user-isolation helpers (/rls). - Key-Value store — regional, quota-protected KV with TTL, audit trail, and dashboard expose rules (/v1/:app/kv/*). New in v0.2.0. - File storage — S3/R2-backed object storage with presigned URLs, ACLs, and async indexing (/storage).
Compute - Serverless functions — TypeScript functions executed on the Deno runtime (/functions). - Durable Objects — stateful per-key actors for chat rooms, multiplayer, rate limiters, long-running agents (/durable-objects). - Realtime — WebSocket subscriptions to table changes for live UIs and presence (/realtime). - Edge SSR — deploy Next.js / Remix / Astro edge handlers from source (/edge-ssr, /edge-ssr-from-source). - Frontend hosting — zip or build-from-source static / SPA deploys with custom domains (/frontend, /custom-domains).
AI - AI gateway — single endpoint for chat, embeddings, model listing; pluggable router adapters (/gateway, /ai-config). - RAG — managed collections, document ingestion, semantic search and synthesized answers (/rag). - Integrations — third-party tool access via Composio (/integrations).
Identity & ops - Auth — email + OAuth (Google, GitHub, Apple, X, …), JWT tuning, post-login hooks, service keys (/auth, /oauth-config, /api-keys). - Audit logs — structured request audit trail across KV and other surfaces (/audit-logs). - Webhooks — outbound webhooks for app events (/webhooks). - Multi-region app moves — relocate an app across regions with retained source replicas (scripts/move-app/).
Agent surface - MCP server — every capability above is exposed as MCP tools at /mcp (HTTP) or via stdio (@butterbase/mcp — npx @butterbase/mcp). - Claude Code plugin — packages/plugin (submodule of butterbase-skills) ships 30+ guided skills (idea → plan → schema → auth → functions → deploy → submit) for agentic app building.
The OSS / managed boundary is intentional. The following are private to the managed offering:
If you need these for self-host, implement against the interfaces in packages/shared — see CONTRIBUTING.md for the scope rules.
npm ci
cp .env.example .envdocker-compose.local.yml sets KV_REDIS_URL_US_EAST_1 for you. Edit .env only if you override defaults (e.g. run control-api on the host — use redis://localhost:6379).
Requirements: Docker, Node 22+, npm.
| Service | URL / port |
|---|---|
| Control API | http://localhost:4000 |
| MCP (HTTP, via control-api) | http://localhost:4000/mcp |
| Deno runtime | http://localhost:7133 |
| Docs site | http://localhost:4321 |
| Control plane Postgres | localhost:5433 |
| Data plane Postgres | localhost:5435 |
| Runtime plane Postgres | localhost:5437 |
| LocalStack (S3) | http://localhost:4566 |
Full setup (auth, MCP clients, troubleshooting, production notes): SETUP.md.
The Claude Code plugin containing skills (packages/plugin) is a git submodule (butterbase-skills). A plain clone leaves packages/plugin/ empty and npm install silently skips that workspace.
git clone --recurse-submodules https://github.com/butterbase-ai/butterbase-oss.git
cd butterbase-ossIf you already cloned without submodules:
git submodule update --init --recursiveOptional — keep submodules updated on every pull:
git config --global submodule.recurse trueThis repo ships the runtime data plane — everything required to self-host a fully featured Butterbase instance. The managed offering at butterbase.ai adds multi-region orchestration, billing, upstream AI router adapters, lease-based quota enforcement, and ops dashboards (those live in a private repo that consumes this one as a submodule).
When you self-host, the AI gateway runs without upstream router adapters, billing uses a no-op provider, and quotas are unlimited. Wire your own implementations via the BillingProvider, QuotaEnforcer, and RouterAdapter interfaces in packages/shared.
ButterBase是一个高质量的开源后端服务工具，支持多种功能
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ Apache 2.0 — 宽松开源协议，可商用，需保留版权声明和 NOTICE 文件，含专利授权条款。
经综合评估，ButterBase 在MCP工具赛道中表现稳健，质量优秀。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。
| 原始名称 | butterbase-oss |
| Topics | baasbackend-as-a-servicemcpopen-sourcepostgrestypescript |
| GitHub | https://github.com/butterbase-ai/butterbase-oss |
| License | Apache-2.0 |
| 语言 | TypeScript |
收录时间：2026-06-01 · 更新时间：2026-06-01 · License：Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。
选择 Agent 类型，复制安装指令后粘贴到对应客户端