用途
Hatchable MCP 用于在任意 MCP 客户端中构建并托管全栈 Web 应用和网站。每个项目都会获得独立的 Postgres 数据库、认证、存储、域名、cron 和邮件能力,并能在数秒内生成一个可访问的线上 URL。平台提供免费套餐,无需消耗 credits。
该仓库包含两部分内容:面向 Claude Code 的 Hatchable 插件(当前目录即插件),以及面向其他所有 MCP 客户端的连接器说明。Hatchable 的代码运行在其自有基础设施上,而非用户本地,因此本地无需构建或安装任何东西。
主要能力
Claude Code 插件
安装插件后连接账户:运行 /mcp,选择 hatchable,完成登录。新账户免费,发布到开放网络的第一个应用也免费。
插件新增内容包括:
- 预配置的 Hatchable MCP 服务器,提供 34 个工具,用于创建项目、写入文件、运行 SQL、部署、读取日志以及 fork 模板。完整参考见 hatchable.com/docs/developers/mcp。
/hatchable:new <description>:根据自然语言描述构建并部署应用,返回一个线上 URL。/hatchable:import:部署当前所在仓库。将文件映射到平台结构,运行校验器,并处理遇到的阻塞问题。/hatchable:fix <what's wrong>:利用平台自身的日志和 dry-run 校验器,诊断被拒绝的部署或损坏的线上应用。hatchable:builder智能体:Claude 可将整个构建任务委派给该应用构建器。它在云端创建、编码、部署并验证,然后返回线上 URL。可通过@hatchable:builder提及,或让 Claude 自行选择。
Hatchable 项目就是一个文件夹:路径变成路由,SQL 文件变成 schema,一个 TOML 文件声明其余内容。平台通过 MCP(list_skills、read_skill)向智能体提供自身的构建模式,因此 Claude 在构建时读取当前约定,而不是依赖训练数据。
若想在安装前从检出目录试用插件:在该目录运行 claude --plugin-dir .。
各客户端设置
Claude Code(终端)
安装插件(见上文),或直接添加服务器。OAuth 会处理其余事项。没有 Claude Code 可在此安装。
Claude.ai(网页)
- 打开 claude.ai/customize/connectors,点击 Connectors 旁的 +。
- 在 Add custom connector 对话框中,命名为 Hatchable,粘贴 https://hatchable.com/mcp,点击 Add。
- Claude 会重定向到 hatchable.com 进行批准——这会创建你的免费账户。
适用于 Free(1 个连接器)、Pro、Max、Team 和 Enterprise。在 Team/Enterprise 中,由所有者从 Organization settings → Connectors 添加。
ChatGPT
- 打开 chatgpt.com/apps#settings/Connectors/Advanced,开启 Developer Mode,点击 Create app。
- 命名为 Hatchable,在 MCP Server URL 下粘贴 https://hatchable.com/mcp,保留 OAuth,勾选同意框,点击 Create。
- ChatGPT 会重定向到 hatchable.com 进行批准——这会创建你的免费账户。
需要 Plus、Pro、Business、Enterprise 或 Edu 套餐(Developer Mode 的前提条件)。
Codex
- 打开 Codex → Settings → MCP servers → + Add server。
- 命名为 Hatchable,选择 Streamable HTTP,粘贴 https://hatchable.com/mcp,保存。
- 在新行上点击 Authenticate,并在 hatchable.com 的弹窗中批准——这会创建你的免费账户。
没有 Codex 可在此下载。
Cursor
粘贴到 ~/.cursor/mcp.json。注册后从 hatchable.com/console/settings?tab=api-keys 获取 token(10 秒,无需信用卡)。
Google Antigravity
- 打开命令面板(Cmd/Ctrl + Shift + P)。
- 选择 Antigravity: Manage MCP Servers,然后点击 View raw config。
- 粘贴并保存:
{ "mcpServers" : { "hatchable" : { "serverUrl" : "https://hatchable.com/mcp" } } } - 重新打开 Manage MCP Servers,在 hatchable 行上点击 Authenticate,并在 hatchable.com 上批准。
没有 Antigravity 可从 Google 下载——免费,无需信用卡。
其他 MCP 客户端
任何支持 Streamable HTTP + OAuth 的客户端均可使用。将 https://hatchable.com/mcp 配置为端点,让客户端处理 OAuth 流程。仅支持 bearer token 的客户端应发送 Authorization: Bearer <API_KEY>,密钥来自控制台。
工具面(可执行操作)
端点实时提供 34 个工具:
- 项目生命周期:create_project、get_project、list_projects、update_project、fork_project、create_preview_link
- 文件:write_file、write_files、patch_file、read_file、grep、list_files、delete_file、upload_file、list_pending_uploads、import_file_from_url
- 数据库:execute_sql、get_schema
- 部署与可观测性:dry_run_deploy、deploy、list_deployments、get_deployment、list_functions、run_function、run_code、view_logs、list_cron_jobs
- 智能体任务:list_agent_tasks、update_agent_task(项目所有者在控制台中提交的自然语言请求)
- 指引与发现:list_skills、read_skill、search_documentation、search_projects、submit_platform_feedback
每个项目都附带专用 Postgres 数据库、内置认证(邮箱验证码和 OAuth 提供商)、cron 调度、对象存储、邮件发送和 AI 路由,全部通过处理程序内的 hatchable SDK 访问。无需 npm install,无需构建步骤。SDK 和处理程序契约见 hatchable.com/docs/developers。
仓库还包含:
server.json— MCP Registry 清单(schema 版本 2025-12-11),也通过 hatchable.com/server.json 和 hatchable.com/.well-known/mcp/server.json 提供。smithery.yaml— Smithery 提交配置。
安全与认证
- OAuth 元数据(RFC 8414):
/.well-known/oauth-authorization-server - 受保护资源元数据(RFC 9728):
/.well-known/oauth-protected-resource - 支持动态客户端注册(RFC 7591)——MCP 客户端可自动注册自身。
- Bearer token 按账户划分作用域,可在控制台中轮换或撤销。
Docker(用于注册表和扫描器)
仓库中的 Dockerfile 是一个小型 stdio-to-HTTP 代理(proxy.mjs)。它的存在是为了让期望可运行容器的注册表和质量扫描器(Glama、Smithery 等)能够内省工具面。最终用户无需构建它——直接在 MCP 客户端中配置 https://hatchable.com/mcp,让客户端原生 HTTP 传输与服务器通信即可。
适用场景
- 希望通过自然语言描述快速构建并部署全栈 Web 应用或网站。
- 希望将现有仓库导入并部署到托管平台。
- 需要为每个项目自动配置数据库、认证、存储、域名、cron 和邮件。
- 在 Claude Code、Claude.ai、ChatGPT、Codex、Cursor、Google Antigravity 等 MCP 客户端中集成托管能力。
限制
- 代码运行在 Hatchable 基础设施上,本地无需构建或安装。
- ChatGPT 集成需要 Plus、Pro、Business、Enterprise 或 Edu 套餐(Developer Mode 前提)。
- Claude.ai 免费版仅支持 1 个连接器。
- 仅支持 bearer token 的客户端需手动提供 API 密钥。
- 仓库采用 MIT 许可,详见 LICENSE。
联系方式
- 网站:hatchable.com
- 邮箱:hello@hatchable.com
- 问题反馈:MCP 集成问题可在本仓库提交 issue;账户或账单问题请使用控制台内支持流程。