关于 Bool
Bool 是官方插件,用于将 AI 助手连接到 Bool 托管服务;该服务可根据描述构建并发布 Web 应用。插件为多种受支持的插件客户端提供 Bool 的 MCP 工具及使用指引,并通过 Bool 账户登录。
主要功能
- 01连接 Bool 托管 MCP 服务
- 02附带 Bool 工具使用技能
- 03面向多种客户端的插件清单
- 04通过 Bool 账户进行 OAuth 登录
适用场景
- 01根据描述构建 Web 应用
- 02发布使用 Bool 构建的 Web 应用
- 03从 MCP 客户端使用 Bool 工具
MCP 相关
插件通过 Streamable HTTP 将客户端连接到 Bool 托管的 MCP 服务 `https://bool.com/api/mcp`。用户使用 Bool 账户通过 OAuth 认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://bool.com/api/mcpclaude mcp add --transport http com-bool-bool https://bool.com/api/mcp{"mcpServers":{"com-bool-bool":{"type":"http","url":"https://bool.com/api/mcp"}}}在 Cursor 中打开{"servers":{"com-bool-bool":{"type":"http","url":"https://bool.com/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-bool-bool":{"type":"http","url":"https://bool.com/api/mcp"}}}{"mcpServers":{"com-bool-bool":{"serverUrl":"https://bool.com/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Bool 插件
Bool 的官方插件。Bool 可以根据描述构建并发布 Web 应用。Bool 由 CodeHS, Inc. 运营。
该插件将 AI 助手连接到 Bool 托管的 MCP 服务 https://bool.com/api/mcp,并添加一项技能,告诉助手如何使用 Bool 的工具。它不运行自己的服务,也不保存任何密钥。用户通过 OAuth 使用 Bool 账户登录。该插件采用 MIT 许可证。
安装
| 客户端 | 方法 |
|---|---|
| ChatGPT 和 Codex | 上架后,在插件目录中搜索 Bool。 |
| Cursor | 依次选择 Customize、Marketplace,然后搜索 Bool。 |
| Grok Build | 依次选择 Settings、Plugins,然后搜索 Bool。 |
| 其他 MCP 客户端 | 添加 https://bool.com/api/mcp 作为远程 MCP 服务,并使用 Bool 登录。 |
目录结构
一个仓库服务于所有客户端。共享部分遵循 Agent Plugins 格式,ChatGPT、Codex、Cursor、VS Code 和 GitHub Copilot 都可直接读取。需要额外内容的客户端各自使用一个小型文件。
| 路径 | 读取方 | 内容 |
|---|---|---|
plugin.json | Agent Plugins 客户端 | 名称、版本、发布者。OpenAI 上架信息、审核案例和发行说明位于 extensions.com.openai 下。 |
mcp.json | Agent Plugins 客户端 | 使用 Streamable HTTP 的 bool 服务。 |
skills/bool/SKILL.md | 所有客户端 | 何时以及如何使用 Bool 的工具。 |
assets/ | 所有客户端 | 图标、徽标和字标。 |
.cursor-plugin/plugin.json | Cursor | 显示名称和徽标。 |
.claude-plugin/plugin.json、.mcp.json | Claude Code、Grok Build | 使用各自清单格式的同一插件。 |
server.json | 官方 MCP Registry | 注册表条目 com.bool/bool。 |
确保四个清单中的版本一致。CI 会检查这一点。
发布到 MCP Registry
mcp-publisher login http --domain bool.com --private-key "$(openssl pkey -in ~/.config/bool/mcp-registry-key.pem -noout -text | grep -A3 priv: | tail -n +2 | tr -d ' :\n')"
mcp-publisher publish
bool.com 在 /.well-known/mcp-registry-auth 提供对应的公钥。重新发布前,请更新 server.json 中的 version。
发布到 OpenAI 插件目录
scripts/build-openai-zip.sh
该脚本会生成 dist/bool-<version>.zip,其中仅包含 OpenAI 会读取的文件:plugin.json、mcp.json、skills/、assets/、README.md 和 LICENSE。在 OpenAI Platform 的 Bool 插件页面中,点击 Upload plugin to make changes 上传。插件列表中的 Upload new or existing plugin 按钮会创建一个单独的插件。
支持
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。