内容
# Hatchable MCP
[](https://registry.modelcontextprotocol.io/v0/servers?search=hatchable)
[](./LICENSE)
从任何MCP客户端在Hatchable上构建和托管全栈Web应用和网站。每个项目都拥有自己的Postgres数据库、身份验证、存储、域名和定时任务——并且在几秒钟内获得一个实时网址。免费层,无需信用卡。
| | |
|---|---|
| **终端点** | `https://hatchable.com/mcp` |
| **传输协议** | 可流式HTTP(MCP 2025-03-26) |
| **身份验证** | OAuth 2.1,支持PKCE和动态客户端注册(RFC 7591)。备用Bearer令牌。 |
| **注册中心** | [`com.hatchable/hatchable`](https://registry.modelcontextprotocol.io/v0/servers?search=hatchable) |
| **主页** | [hatchable.com](https://hatchable.com) |
| **文档** | [hatchable.com/docs](https://hatchable.com/docs) |
本仓库是一个薄连接器——Hatchable的代码在我们的基础设施上运行,而不是在您的基础设施上运行。您无需在本地安装任何东西。您只需在MCP客户端配置终端点,并使用OAuth(或Bearer令牌)登录。
## 按客户端设置
### Claude Code(终端)
一条命令,OAuth处理其他所有事情:
```bash
claude mcp add --transport http hatchable https://hatchable.com/mcp
```
没有Claude Code?[在这里安装](https://claude.com/claude-code)。
### Claude.ai(网页)
1. 打开 [claude.ai/customize/connectors](https://claude.ai/customize/connectors) 并点击 **+** 在 **连接器** 旁边。
2. 在 **添加自定义连接器** 对话框中,命名为 **Hatchable**,粘贴 `https://hatchable.com/mcp`,然后点击 **添加**。
3. Claude 重定向您到 hatchable.com 进行批准——这会创建您的免费帐户。
适用于免费(1个连接器)、Pro、Max、Team 和 Enterprise。在 Team/Enterprise 上,拥有者从 *组织设置 → 连接器* 添加它。
### ChatGPT
1. 打开 [chatgpt.com/apps#settings/Connectors/Advanced](https://chatgpt.com/apps#settings/Connectors/Advanced),启用 **开发者模式**,然后点击 **创建应用**。
2. 命名为 **Hatchable**,在 **MCP 服务器网址** 下粘贴 `https://hatchable.com/mcp`,保持 **OAuth**,勾选同意框,然后点击 **创建**。
3. ChatGPT 重定向您到 hatchable.com 进行批准——这会创建您的免费帐户。
需要 Plus、Pro、Business、Enterprise 或 Edu 计划(开发者模式前提条件)。
### Codex
1. 打开 Codex → **设置 → MCP 服务器 → + 添加服务器**。
2. 命名为 **Hatchable**,选择 **可流式HTTP**,粘贴 `https://hatchable.com/mcp`,然后 **保存**。
3. 点击新行中的 **身份验证** 并在 hatchable.com 上批准弹出窗口——这会创建您的免费帐户。
没有 Codex?[在这里下载](https://openai.com/codex)。
### Cursor
在 `~/.cursor/mcp.json` 中粘贴:
```json
{
"mcpServers": {
"hatchable": {
"url": "https://hatchable.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_HATCHABLE_TOKEN"
}
}
}
}
```
在注册后(10秒,无需信用卡),从 [hatchable.com/console/settings?tab=api-keys](https://hatchable.com/console/settings?tab=api-keys) 获取您的令牌。
### Google Antigravity
1. 打开命令面板(**Cmd/Ctrl + Shift + P**)。
2. 选择 **Antigravity: 管理MCP服务器**,然后点击 **查看原始配置**。
3. 粘贴并保存:
```json
{
"mcpServers": {
"hatchable": {
"serverUrl": "https://hatchable.com/mcp"
}
}
}
```
4. 重新打开 **管理MCP服务器**,点击 hatchable 行中的 **身份验证**,并在 hatchable.com 上批准。
没有 Antigravity?[从 Google 下载](https://antigravity.google) —— 免费,无需信用卡。
### 其他MCP客户端
任何支持可流式HTTP + OAuth的客户端都可以使用。配置 `https://hatchable.com/mcp` 作为终端点,并让客户端处理OAuth流程。仅支持Bearer令牌的客户端应发送 `Authorization: Bearer <API_KEY>`,其中密钥来自 [控制台](https://hatchable.com/console/settings?tab=api-keys)。不发送任何身份验证的客户端将在第一次 `initialize` 时收到一个待处理密钥,可以为未来的调用持久化。
## 您可以使用(工具表面)
Hatchable 暴露了30多种工具。亮点:
- **项目生命周期** — `create_project`、`get_project`、`list_projects`、`fork_project`、`set_visibility`、`update_project`
- **文件** — `write_file`、`write_files`、`read_file`、`grep`、`list_files`、`patch_file`、`delete_file`、`import_file_from_url`、`upload_file`
- **数据库** — `execute_sql`、`get_schema`
- **部署 + 可观察性** — `deploy`、`dry_run_deploy`、`run_function`、`run_code`、`view_logs`、`list_deployments`、`get_deployment`、`list_functions`、`list_cron_jobs`
- **环境** — `set_env`、`list_env`、`delete_env`
- **发现** — `search_projects`、`search_documentation`
每个项目都配备了Node.js 20、专用的Postgres数据库、内置身份验证(电子邮件 + OAuth提供程序)、定时任务、对象存储和电子邮件发送。有关完整的SDK和处理程序合同,请参阅 [hatchable.com/docs](https://hatchable.com/docs)。
## 清单
- [`server.json`](./server.json) — MCP注册中心清单(模式版本2025-12-11),也可在 [`hatchable.com/server.json`](https://hatchable.com/server.json) 和 [`hatchable.com/.well-known/mcp/server.json`](https://hatchable.com/.well-known/mcp/server.json) 处提供。
- [`smithery.yaml`](./smithery.yaml) — Smithery提交配置。
## 安全性和身份验证
- OAuth元数据(RFC 8414):[`/.well-known/oauth-authorization-server`](https://hatchable.com/.well-known/oauth-authorization-server)
- 受保护资源元数据(RFC 9728):[`/.well-known/oauth-protected-resource`](https://hatchable.com/.well-known/oauth-protected-resource)
- 支持动态客户端注册(RFC 7591)——MCP客户端可以自动注册自己。
Bearer令牌按帐户范围限定。您可以在 [控制台](https://hatchable.com/console/settings?tab=api-keys) 中轮换或撤销它们。
## Docker(用于注册中心和扫描程序)
本仓库中的 [`Dockerfile`](./Dockerfile) 是一个薄的stdio到HTTP代理,基于 [`mcp-remote`](https://github.com/geelen/mcp-remote) 构建。它存在于注册中心和质量扫描程序(Glama、Smithery等)期望可运行容器的情况下,可以对工具表面进行内省。终端用户无需构建它——只需在MCP客户端中配置 `https://hatchable.com/mcp` 并让客户端的原生HTTP传输与服务器通信。
```bash
docker build -t hatchable-mcp .
docker run --rm -i hatchable-mcp # stdio ↔ https://hatchable.com/mcp
```
## 许可证
MIT。参见 [`LICENSE`](./LICENSE)。
## 联系
- **网站:** [hatchable.com](https://hatchable.com)
- **电子邮件:** hello@hatchable.com
- **问题:** 在此仓库中提交问题以获取MCP集成问题;使用控制台内的支持流程获取帐户或计费问题。