Busabase

MCP开发工具

提供方 Kelly Peilin Chan

开发工具 Streamable HTTP OAuth 授权 社区 / 第三方 ClaudeCursorVS CodeCodex

Busabase is the system of record for AI agents — an open-source (MIT) database and workspace where agents and people share the same data, docs, skills, and apps. Every change keeps its history, and the writes that matter

一句话选型结论

按资料字段整理

Busabase 属于开发工具类 MCP 服务器,Streamable HTTP,OAuth 授权,可直接接入 Claude、Cursor、VS Code 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式Streamable HTTP 鉴权OAuth 授权 部署方式支持远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

aigithubknowledge base

安装与配置

Streamable HTTP OAuth 授权
新一代远程传输,替代 SSE
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude、Cursor、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Busabase当前 未标注 Streamable HTTP 支持远程部署 无 2026-11-20
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Kelly Peilin Chan上游标注的维护方 Kelly Peilin Chan
分类开发工具本站按上游分类展示
连接方式Streamable HTTP新一代远程传输,替代 SSE
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-11-20上游最后核验时间

详细介绍

11.8 KB
来自项目仓库与上游目录的原文,未做删改

Busabase Skills & Plugins

English · 简体中文 · 繁體中文 · 日本語

Agent Skills + plugins for Busabase — the open-source database and workspace
for AI agents. Every write is a change request with a message and a diff: it lands at once with
write access and waits for a person's review otherwise.

Seven skills, five ways to install them — pick whatever your agent supports.

Install

skills (Claude Code, Cursor, Codex, … — evergreen)```bash

npx skills add busabase/skills


### Agent Plugins v1 (portable package)

The repository root follows the Agent Plugins Specification v1.0.0:
`plugin.json` is the portable manifest, `skills/` contains the Agent Skills, and `mcp.json`
declares the hosted Streamable HTTP MCP server. Install or load this repository root with any
client that supports the Agent Plugins format.

Agent Plugins v1 leaves OAuth and credentials to the client. Existing Claude Code and Codex
packages keep their dedicated browser-OAuth behavior. See
`docs/agent-plugins.md` for the compatibility mapping and validation.

### Claude Code plugin```bash
claude plugin marketplace add https://github.com/busabase/skills.git
claude plugin install busabase@busabase
claude mcp login plugin:busabase:busabase

The Claude Code plugin connects to https://busabase.com/api/mcp with browser OAuth. Claude
namespaces its bundled server as plugin:busabase:busabase. Start a new conversation after install
and login so the authenticated tool catalog is available. See
docs/claude-code-install.md for the complete verification and
recovery flow.

Maintainers should also read
docs/codex-to-claude-code-port.md for the host-by-host
manifest, MCP, OAuth, skill, and validation differences.

Codex plugin```bash

codex plugin marketplace add busabase/skills
codex plugin add busabase@busabase
codex mcp login busabase


The Codex plugin connects to `https://busabase.com/api/mcp`, opens the standard browser OAuth
flow, and exposes a focused 22-tool catalog. No API key setup is required.

Plugin installation and MCP authorization are separate states. After the browser says
`Authentication complete`, verify the saved connection before starting a Busabase task:```bash
codex mcp list

The busabase row should show Auth as OAuth. If it still shows Not logged in, run
codex mcp login busabase again and complete the newly opened browser tab while that command is
still running. Start a new Codex task after a successful login so the task loads the authenticated
tool catalog.

WorkBuddy connector

Install Busabase from the WorkBuddy Connector marketplace (WorkBuddy 4.24.0 or later) and
authorize it in the browser. WorkBuddy runs the OAuth flow in its cloud and keeps the token, so
there is nothing to configure locally. The package source lives in workbuddy/;
it is submitted to WorkBuddy for review rather than installed from this repo.

Doubao Work native plugin

The doubao/ package bundles the Busabase MCP connection and the shared
busabase skill. It uses standard MCP OAuth: install through the plugin entry available
in your Doubao Work account and complete browser consent. Installation and authorization
are separate steps. See the package guide for the ZIP layout and
acceptance checklist. Package validation is complete; native-client installation and
platform approval must be recorded separately.

More native platforms

Each package has its own installation and update instructions. Installing a
package does not complete OAuth or submit it to a marketplace.

Platform Package / instructions Distribution note
Gemini CLI gemini/ Code Assist enterprise/API audiences; root extension archive or dedicated repository
Antigravity CLI antigravity/ Separate native manifest and MCP configuration
Cursor cursor/ Native Agent Plugin; public Marketplace review is separate
Grok Build grok/ Native Grok plugin; external marketplace contribution
Kimi Code / Work kimi/ One native plugin format; Work import needs account verification
Kiro kiro/ Agent Plugins format; registry review is separate
Copilot CLI copilot/ Use the included marketplace for durable updates
Perplexity Computer perplexity/ Custom plugin ZIP/GitHub import; paid-plan permissions may apply
MiniMax Code minimax/ Full CLI Skill; authenticated MCP requires provider onboarding
Base44 base44/ Not a marketplace package: a kit you copy into your Base44 project (custom-integration OpenAPI, two-way sync functions and workflows, MCP guide). No Base44 catalog exists; live-app verification is still pending

Existing integrations also cover Junie, Pi, Paseo
and portions of Hermes. See OpenHands and
Agent Zero for catalog drafts and remaining requirements.

MCP (any MCP-capable agent)

Point your agent at your workspace's Streamable-HTTP endpoint:

  • Desktop / local: http://localhost:15419/api/mcp (no auth)
  • Cloud: https://busabase.com/api/mcp — sign in with OAuth in the browser; there is no API
    key to paste.
    Any client that supports OAuth for remote MCP servers (Claude Code, Codex and
    a growing list of others) can connect this way. For headless automation, a Bearer API key
    (Authorization: Bearer $BUSABASE_API_KEY) works on the same endpoint.

Generic OAuth example (Codex shown; the flow is the same for any OAuth-capable client):```bash
codex mcp add busabase --url https://busabase.com/api/mcp
codex mcp login busabase


The portable root `mcp.json` declares the hosted endpoint using the Agent Plugins v1
format. The legacy root `.mcp.json` continues to wire the local endpoint for general
MCP clients. The Claude
package uses its own hosted OAuth MCP configuration. The Codex plugin has a
separate remote MCP configuration.

The root **busabase** skill remains the full CLI/curl guide for local and general-purpose agent
installs. The Claude- and Codex-bundled skills are intentionally MCP-first: they rely on OAuth and
the curated tool catalog instead of reading `~/.busabase/.env`.

To set up a workspace from scratch first, paste the onboarding prompt from your Busabase dashboard
(**Agent Skills** button) — it walks your agent through connecting, seeding a first Base, and then
running one of the install commands above.

## Skills

| Skill | What it does |
| --- | --- |
| `busabase` | Drive a Busabase workspace over HTTP: list Bases/records, propose ChangeRequests, and merge approved ones. The full CLI / API / MCP reference. |
| `busabase-ops` | Operate a workspace day to day — dedupe-before-create, schema-first writes, attach-and-make-searchable filing, audits and clean-ups — with read-before-write discipline, checking what actually landed. A full copy of `busabase` under the operator's name. |
| `busabase-app-creator` | Turn a product idea into a complete Busabase workspace app with native resources, bounded data access, and a reviewable AirApp. |
| `busabase-template-creator` | Author and publish templates to the public `busabase/templates` catalog, layered on the app-creator contract. |
| `busabase-app-package-creator` | Alias of `busabase-app-creator` for packaging an existing AirApp into an installable package. |
| `busabase-package-creator` | Alias of `busabase-app-creator` for authoring a Busabase package (manifest, contents, versioning). |
| `busabase-skill-creator` | Alias of `busabase-app-creator` for creating a Busabase Skill and packaging it for installation. |

> **Looking for installable templates?** Complete apps — tables, an AirApp and
> the manual an agent reads — live in busabase/templates.
> They are kept separate so installing these two skills does not pull down every
> template's source and screenshots.

## Repo layout

This one repo serves every install path above:```
plugin.json                           Agent Plugins v1 portable manifest
mcp.json                              Agent Plugins v1 hosted MCP profile
skills/busabase/SKILL.md              canonical local/general-purpose skill
skills/busabase-ops/SKILL.md          day-to-day workspace operator entry point
skills/busabase-app-creator/SKILL.md  guided Busabase workspace and AirApp creator
skills/busabase-*-creator/SKILL.md    template creator + three alias entries: full copies
                                      of busabase-app-creator under task names (real files,
                                      not symlinks — the skills CLI does not follow symlinks)
.claude-plugin/marketplace.json       Claude Code marketplace listing
claude/.claude-plugin/plugin.json     Claude Code plugin manifest
claude/.mcp.json                      hosted OAuth MCP profile for Claude Code
claude/skills/busabase/SKILL.md       Claude-specific MCP-first connection guidance
claude/skills/busabase-app-creator/   symlink to the shared app creator skill
.agents/plugins/marketplace.json      Codex marketplace listing
plugins/busabase/.codex-plugin/plugin.json   Codex plugin manifest
plugins/busabase/.mcp.json                   hosted OAuth MCP profile for Codex
plugins/busabase/skills/busabase/SKILL.md    Codex needs the skill INSIDE the plugin dir
                                             (MCP-first guidance for the curated profile)
plugins/busabase/skills/busabase-app-creator/SKILL.md
                                             app creator bundled beside its Busabase dependency
plugins/busabase/assets/                     icons and light/dark logos bundled with Codex
workbuddy/connector-meta.json         WorkBuddy connector metadata + server-side OAuth declaration
workbuddy/mcp.json                    hosted MCP server for WorkBuddy
workbuddy/skills/busabase/SKILL.md    WorkBuddy-specific MCP-first guidance (same shared body)
.mcp.json                             legacy/general-client local MCP profile
server.json                           official MCP Registry entry (remote → busabase.com/api/mcp)
scripts/validate-agent-plugin.mjs     portable and client-package conformance guard

> Why host-specific Busabase skills? The plugin packages use hosted OAuth and MCP tools instead
> of local shell configuration. Claude Code additionally namespaces the server as
> plugin:busabase:busabase, while Codex uses busabase. The shared busabase-app-creator skill
> delegates connection, API, and ChangeRequest behavior to the host-specific MCP-first dependency.

Validate release metadata

Maintainer validation uses Node.js 22+ and Python 3:```bash
node --test scripts/strict-json.test.mjs
node scripts/validate-agent-plugin.mjs


The release guard checks original JSON text for duplicate object keys, including escaped and
nested names that `JSON.parse` would silently overwrite. Missing Python fails validation closed.
Python is needed only by these publishing checks; it is not bundled into a plugin or required
to run one.

## Publish to the OpenAI Plugin Directory

The OpenAI Plugin Directory and the MCP Registry are separate release channels. Use
`docs/openai-plugin-submission.md` for the Platform submission,
domain verification, reviewer access, test prompts, and production smoke checks.

## Publish to the official MCP Registry```bash
brew install mcp-publisher                       # or grab the binary from the registry releases
mcp-publisher login dns --domain busabase.com --private-key <KEY>   # verifies the com.busabase/* namespace
mcp-publisher publish                            # publishes server.json — live immediately, no review

Bump version in server.json only when publishing an MCP Registry update. Bump the Codex plugin
manifest independently for GitHub marketplace releases.

Privacy and support

The hosted MCP service processes the Busabase workspace data that the connected user authorizes.
See the Busabase Privacy Policy for its data practices.
The plugin does not bundle credentials; the host manages the OAuth connection.

For installation, package or connection problems, open a support issue.
Do not include credentials or private workspace data in a public issue.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Busabase 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Busabase 怎么在 Claude、Cursor、VS Code 里配置?

它的传输方式是Streamable HTTP,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Busabase 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Busabase 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Busabase 支持哪些客户端?

资料标注支持 Claude、Cursor、VS Code、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Busabase 能提供哪些能力?

资料显示能力标签包括 ai、github、knowledge base、ai agents。具体工具清单以官方文档为准。

Busabase 需要什么运行环境?

运行时为 Cross-platform;属于远程端点,不需要在本地装运行时。

Busabase 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为Streamable HTTP。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-11-20。