mcpField
B
busabase

busabase

远程服务
busabase.com数据库22 天前更新

关于 busabase

Busabase Skills & Plugins 为 Busabase 提供两种 Agent Skill;Busabase 是面向 AI Agent 的开源数据库与工作区。它支持工作区数据操作和应用创建;没有写入权限时,写入会作为可审核的变更请求提交。

主要功能

  1. 01列出 Base 和记录
  2. 02提出并合并变更请求
  3. 03创建工作区应用
  4. 04通过 Skill 或插件安装

适用场景

  1. 01审核工作区数据变更提案
  2. 02根据产品构想创建 Busabase 应用

MCP 相关

插件声明了位于 https://busabase.com/api/mcp 的托管 Streamable HTTP MCP 服务,并说明本地端点。Claude Code 和 Codex 通过浏览器 OAuth 连接托管服务;Codex 提供经过筛选的工具目录。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://busabase.com/api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Busabase 技能与插件

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

适用于 Busabase 的 Agent Skills + 插件——这是面向 AI Agent 的开源数据库和工作空间。每次写入都会成为一项变更请求,附带消息和差异:拥有写入权限时会立即生效,否则会等待人工审核。

两项技能,五种安装方式——选择 Agent 支持的方式即可。

安装

skills(Claude Code、Cursor、Codex 等——持续更新)
npx skills add busabase/skills
Agent Plugins v1(可移植包)

仓库根目录遵循 Agent Plugins Specification v1.0.0: plugin.json 是可移植清单,skills/ 包含 Agent Skills,mcp.json 声明托管的 Streamable HTTP MCP 服务。任何支持 Agent Plugins 格式的客户端都可以安装或加载此仓库根目录。

Agent Plugins v1 将 OAuth 和凭据交由客户端处理。现有的 Claude Code 和 Codex 包保留了各自专用的浏览器 OAuth 行为。有关兼容性映射和验证,请参阅 docs/agent-plugins.md。

Claude Code 插件
claude plugin marketplace add https://github.com/busabase/skills.git
claude plugin install busabase@busabase
claude mcp login plugin:busabase:busabase

Claude Code 插件通过浏览器 OAuth 连接到 https://busabase.com/api/mcp。Claude 将其捆绑的服务命名空间设为 plugin:busabase:busabase。安装并登录后,请开始新的对话,以加载经过身份验证的工具目录。完整的验证和恢复流程请参阅 docs/claude-code-install.md。

维护者还应阅读 docs/codex-to-claude-code-port.md,了解各主机在清单、MCP、OAuth、技能和验证方面的差异。

Codex 插件
codex plugin marketplace add busabase/skills
codex plugin add busabase@busabase
codex mcp login busabase

Codex 插件连接到 https://busabase.com/api/mcp,打开标准的浏览器 OAuth 流程,并提供一个精简的 22 工具目录。无需设置 API 密钥。

插件安装和 MCP 授权是两个独立的状态。浏览器显示 Authentication complete 后,请先验证已保存的连接,再开始 Busabase 任务:

codex mcp list

busabase 行的 Auth 应显示为 OAuth。如果仍显示 Not logged in,请再次运行 codex mcp login busabase,并在该命令仍在运行时完成新打开的浏览器标签页。登录成功后,请开始新的 Codex 任务,以便加载经过身份验证的工具目录。

MCP(任何支持 MCP 的 Agent)

将 Agent 指向工作空间的 Streamable-HTTP 端点:

  • 桌面 / 本地:http://localhost:15419/api/mcp(无需身份验证)
  • 云端:https://busabase.com/api/mcp(发送 Authorization: Bearer $BUSABASE_API_KEY)

Codex 可以通过标准 OAuth 直接使用完整的云端 MCP 功能:

codex mcp add busabase --url https://busabase.com/api/mcp
codex mcp login busabase

根目录中的可移植文件 mcp.json 使用 Agent Plugins v1 格式声明托管端点。旧版根目录文件 .mcp.json 仍会为通用 MCP 客户端配置本地端点。Claude 包使用其自己的托管 OAuth MCP 配置。Codex 插件则有单独的远程 MCP 配置。

根目录的 busabase 技能仍是面向本地和通用 Agent 安装的完整 CLI/curl 指南。Claude 和 Codex 捆绑的技能则刻意采用 MCP 优先的方式:它们依赖 OAuth 和精选工具目录,而不是读取 ~/.busabase/.env。

若要从头开始设置工作空间,请先粘贴 Busabase 控制面板中的入门提示词(Agent Skills 按钮)——它会引导 Agent 完成连接、创建第一个 Base,然后运行上述某条安装命令。

技能

技能功能
busabase通过 HTTP 操作 Busabase 工作区:列出 Bases/记录、提出 ChangeRequests,并合并已批准的请求。
busabase-app-creator将产品创意转化为完整的 Busabase 工作区应用,包含原生资源、受限的数据访问,以及可供审核的 AirApp。

想找可安装的模板? 完整应用——表格、AirApp 以及 Agent 阅读的手册——位于 busabase/templates。 它们单独存放,这样安装这两个技能就不会一并下载所有模板的源文件和截图。

仓库布局

这个仓库支持上述所有安装方式:

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-app-creator/SKILL.md  guided Busabase workspace and AirApp creator
.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
.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

为什么要提供针对特定宿主的 Busabase 技能? 插件包使用托管 OAuth 和 MCP 工具,而不是本地 shell 配置。此外,Claude Code 将服务命名空间设为 plugin:busabase:busabase,而 Codex 使用 busabase。共享的 busabase-app-creator 技能 将连接、API 和 ChangeRequest 行为委托给针对特定宿主、以 MCP 为优先的依赖项。

发布到 OpenAI Plugin Directory

OpenAI Plugin Directory 和 MCP Registry 是两个独立的发布渠道。有关 Platform 提交、 域名验证、审核人员访问权限、测试提示词和生产环境冒烟测试,请参阅 docs/openai-plugin-submission.md。

发布到官方 MCP Registry

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

仅在发布 MCP Registry 更新时,才更新 server.json 中的 version。对于 GitHub marketplace 发布,应单独更新 Codex 插件清单。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。