用途
lizard-mcp 是一个 MCP 服务器，用于在 Lizard（lizard.build）平台上部署和管理应用。连接一次后，即可让 ChatGPT、Claude 及其他 MCP 客户端用自然语言完成发布服务、读取日志、设置密钥、扩缩容副本或绑定域名等操作。
主要能力
- 提供 33 个工具，覆盖部署、日志、密钥、扩缩容、域名等管理操作。
- 支持 OAuth 2.1 认证，作为 MCP 受保护资源（RFC 9728）。
- 破坏性工具（service_delete、secrets_delete、domain_delete、ssh_exec）需要显式确认参数，防止客户端误删或误执行任意命令。
- billing_status 为只读工具，显示套餐信息（Pro 每月 19 美元，每月含 19 美元额度；试用；预付额度至 2026 年 11 月 1 日；或企业版）及 Billing 链接。Pro 的启动、支付和取消需在浏览器中完成。当账户需先付费才能创建资源时，工具错误会返回平台提示语句及需打开的页面，structuredContent.error 携带错误码（PAYMENT_REQUIRED）、paymentStatus 和链接。
- 每个请求构建一个绑定调用者令牌的新服务器，一个进程可服务多用户且不共享状态。
使用方式
连接客户端
服务器在 POST /mcp 上使用 Streamable HTTP，也支持 stdio 供本地进程客户端使用。托管实例运行于指定地址。每个请求携带 bearer token。支持 OAuth 的客户端可自行获取令牌，无需粘贴；仅发送请求头的客户端使用 liz_ API 密钥。仪表盘可在 Sandboxes → Get started → New API key 创建相同密钥，密钥仅显示一次。
Claude Code 首次使用时运行 OAuth 流程。若要跳过并使用密钥，可参考相关配置。Cursor 及其他通过 JSON 配置的客户端可参考相应说明。ChatGPT 连接 URL 并自行运行 OAuth，无需粘贴密钥，但需要开发者模式并注册连接，详见“发布到 Codex / ChatGPT”部分。
本地服务器
按下一节所述运行后，使用 http://localhost:3000/mcp 替代托管 URL。
检查连接
无令牌时同一调用返回 401 及指向 OAuth 元数据的 WWW-Authenticate 头，这是服务器正常工作而非失败。
开发模式（带重载）
可参考相关命令。
通过 stdio 运行
npm start 提供 HTTP 服务。若要让客户端启动服务器，可指向 dist/stdio.js。被启动的进程没有浏览器运行 OAuth，因此令牌来自环境变量，并将进程绑定到单个用户。没有令牌时服务器仍会启动并列出工具，调用工具则返回要求提供密钥的消息。
工具名称使用 snake_case（而非 MCP 规范允许的点号），以匹配 OpenAI 的函数名模式 ^[a-zA-Z0-9_-]{1,64}$，某些 ChatGPT/Codex 界面会直接强制执行该模式。
适用场景
- 通过 ChatGPT、Claude 等 MCP 客户端以自然语言管理 Lizard 上的应用部署。
- 需要读取日志、设置密钥、扩缩容或绑定域名的运维操作。
- 需要 OAuth 2.1 认证且对破坏性操作有确认保护的多用户环境。
限制
- 破坏性操作需要显式确认参数。
- billing_status 为只读，Pro 的启动、支付和取消需在浏览器中完成。
- 通过 stdio 运行时无 OAuth 和每请求令牌，密钥来自环境变量，进程仅服务一个用户。
- 发布到 Codex / ChatGPT 的最后一步需要人工在真实 ChatGPT 会话中完成，无法脚本化。
- 部分配置细节（如具体命令、JSON 配置示例）在资料中未完整提供。
