Boat House

Name: Boat House
Author: boathousecloud.com

远程服务

boathousecloud.com云与基础设施15 周前更新

代码仓库访问官网

关于 Boat House

Boat House 是供团队借助 AI Agent 构建小型应用的开源基础设施，提供托管或自托管部署、团队访问、持久化数据和版本化更新，并配有命令行、MCP 端点及 Agent 技能。

主要功能

01为应用部署 HTTPS 地址
02团队登录和按工具设置访问角色
03每个工具独立数据库和持久文件
04版本化发布、回滚与备份
05命令行和 Agent 技能

适用场景

01发布 Agent 构建的团队应用
02向受邀编辑者或查看者分享应用
03更新或回滚已部署的应用

MCP 相关

Boat House 提供 MCP 端点，可与其 `bh` 命令行和 Agent 技能配合，用于部署和管理应用。

配置

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

服务地址https://mcp.boathousecloud.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-boathousecloud-boathouse https://mcp.boathousecloud.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-boathousecloud-boathouse":{"type":"http","url":"https://mcp.boathousecloud.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-boathousecloud-boathouse":{"type":"http","url":"https://mcp.boathousecloud.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-boathousecloud-boathouse":{"type":"http","url":"https://mcp.boathousecloud.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-boathousecloud-boathouse":{"serverUrl":"https://mcp.boathousecloud.com/mcp"}}}

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

全部服务地址

Streamable HTTPhttps://mcp.boathousecloud.com/mcp需要授权

工具

参数	类型	必填	说明
workspace	string	否	要操作的工作区标识。属于多个工作区时使用此参数；whoami 会列出这些工作区。

详细介绍

Boat House

为使用 AI Agent 构建的小型软件提供开源基础设施。

Boat House 为工具提供可访问的 HTTPS 地址、登录功能、数据库、持久化文件和电子邮件分享功能。编辑者可在浏览器中使用应用。拥有 Admin 权限的开发者可以使用自己的 Agent 获取其源代码，并向同一地址发布带版本的更新。

本软件采用 Apache 2.0 许可证。你可以在自己的基础设施上运行，也可以使用 Boat House 托管服务。

	自托管	托管服务
软件	Apache 2.0 许可，免费	基于相同的开源基础
基础设施和运维	由你提供并维护	由 Boat House 运营
价格	你承担服务器、域名和服务提供商费用	每个组织每月 $10，最多支持五个轻量级工具；域名需另行购买
开始使用	自托管指南	注册、确认电子邮件，然后将连接信息复制到你的 Agent 中

包含的内容

FastAPI 控制平面和 Caddy HTTPS 网关。
账户登录、电子邮件邀请、针对每个工具的 Viewer / Editor / Admin 访问权限，以及传递给应用的签名身份信息。
每个工具独立的 PostgreSQL 数据库、持久化文件卷、容器资源限制和已保存的源代码版本。
部署、源代码检出、更新、回滚、导出和备份/还原命令。
bh CLI、MCP 端点，以及适用于 Claude Code、Codex 和其他兼容 Agent 的 Agent 技能。
可选的电子邮件、域名注册和预付费计费集成。自托管用户需自行配置服务提供商；也可以禁用计量功能。

Admin 拥有对工具的完全控制权，包括其源代码、密钥、分享和删除操作。软件协作通过源代码检出和带版本的发布实现。应用代码负责执行自身的记录级访问规则。

开始使用托管服务

在 boathousecloud.com 创建账户并确认电子邮件，然后选择 Copy connection，将消息粘贴到你的编码 Agent 中。让它上线一个工具，或通过电子邮件分享工具。部署前请充值。无需单独配置托管、数据库或登录项目。

在 Cursor、Codex 或 Windsurf 中安装 Agent 技能：

npx skills add allenzhangyiteng/boathouse-skills

对于 Claude Code，请添加 /plugin marketplace add allenzhangyiteng/boathouse-skills，然后运行 /plugin install boathouse@boathouse。请参阅技能和插件仓库和安装指南。

在连接账户之前，可以使用 CLI 创建一个可运行的应用：

bh init my-app --template team
cd my-app
python3 app.py --local

HTML 网站请使用 --template static。如果可用，boathouse 是与 bh 一同安装的别名。起始项目采用普通源代码和 boathouse.json 格式，无需专有运行时。请参阅可运行指南、llms.txt 和完整 Agent 文档。

运行自己的安装实例

请参阅自托管指南，了解如何在配有 Docker、DNS 和 HTTPS 的 Linux 主机上部署。公开发布版本不包含账户、凭据、数据库快照、托管客户工具或生产配置。所有示例均使用占位符；请自行生成密钥。

此基础设施面向可信团队和可信应用构建者。控制平面会管理主机的 Docker 守护进程。资源限制和容器网络并不能将其变成可安全运行恶意代码的沙箱。公开部署实例之前，请阅读安全模型。

开发

容器映像使用 Python 3.12。在虚拟环境中：

python -m pip install -r control/requirements.txt -r requirements-dev.txt
python -m pytest -q
python scripts/check_public_tree.py

测试会创建临时本地状态并使用模拟服务提供商。请勿将测试指向生产凭据或状态。CI 会运行测试、发布规范检查和 Gitleaks。

仓库结构

路径	用途
`control/app/`	API、账户界面、网关授权、部署和提供方
`control/site/`	公共网站源码和静态资源
`cli/bh`	使用 Python 标准库的 CLI
`skill/boathouse/`	Agent 指令
`caddy/`, `docker-compose.yml`	网关和服务
`deploy/`	主机安装、同步和备份脚本
`examples/hello/`	用于检查已签名身份的最小应用
`tests/`	使用合成数据的回归测试