light-cloud

Light Cloud MCP 服务

一个 MCP（Model Context Protocol） 服务，可让 Claude 在 Light Cloud Platform 上部署和管理应用程序。

还没有账号？从这里开始

询问 Claude：“用 [email protected] 为我注册 Light Cloud”（或“帮我连接到 Light Cloud”）。你在任意设备上前往 console.light-cloud.com/device 批准一个简短代码后，connect 工具就会创建账号——使用免费套餐，无需银行卡、密码或填写表单。该工具也可用于登录现有账号。然后说：“部署这个项目”“添加一个数据库”或“将工作区切换到 Lite”。整个过程无需访问 Web 控制台。

功能

• 通过终端注册和登录 - 使用邮箱调用 connect；在任意设备上批准代码即可创建账号或登录。无需密码。
• 通过对话管理账单 - 查看套餐和包含的用量，并通过 Stripe Checkout 一键升级（月付或年付）
• 应用程序管理 - 创建、部署和删除应用程序
• 环境管理 - 管理预发布、生产和预览环境
• GitHub 集成 - 直接从 GitHub 仓库部署
• 上传部署 - 无需 GitHub 即可部署本地项目
• 日志、指标和回滚 - 运行时日志和构建日志、环境指标和活动，以及一键回滚
• 框架检测 - 上传的文件夹会由控制台用于检测仓库的同一检测器读取
• 密码保护网站 - 部署时设置 password，即可从第一个请求开始在边缘节点保护网站
• 与控制台功能一致 - 设置、文件夹、技术栈、数据库管理（架构、SQL、转储、导入）、发票和用量提醒、工作区成员、API 密钥（付费套餐）、Git 提供商链接、通知、支持
• 由你掌控的关闭开关 - 在控制台中通过“设置”→“安全”→“Agents & CLI”决定 Agent 可以执行哪些操作；后端会强制执行这些限制

安装

Claude Code

# Add the MCP server
claude mcp add light-cloud -- npx @light-cloud/mcp-server

然后在 Claude Code 中允许使用所有工具，避免重复确认：

/allowed add mcp__light-cloud__*

Claude Desktop（一键扩展）

从最新版本下载 light-cloud-<version>.mcpb 并打开，Claude Desktop 会显示安装对话框。该安装包包含服务及其依赖项；Claude Desktop 自带 Node，无需其他操作。可在扩展页面编辑设置（API 端点、控制台 URL）。

自行构建：npm run bundle → release/light-cloud-<version>.mcpb（此仓库中的 manifest.json 是生成的清单）。

Claude Desktop（手动配置）

将以下内容添加到 claude_desktop_config.json：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "light-cloud": {
      "command": "npx",
      "args": ["@light-cloud/mcp-server"]
    }
  }
}

使用方法

安装后，直接用自然语言与 Claude 对话：

You: Deploy my React app to Light Cloud
Claude: I'll help you deploy. First, let me check your authentication...
        [Opens browser for login]

You: Show me all my applications
Claude: [Lists your applications with status]

You: Check the logs for my-app
Claude: [Fetches and displays recent logs]

可用工具

110 个工具：涵盖控制台中可执行的所有操作。按设计仅限控制台使用：账户密码、双重验证设置，以及 Agents & CLI 开关（见下文）。完整参考文档为每个工具都提供了提示词：https://docs.light-cloud.com/deploy-with-ai/mcp-server#tool-reference

分组	工具
账户	connect、connect-status、login、logout、whoami、get-profile、update-profile、list-connected-devices、sign-out-device、get-agent-access
部署	upload-and-deploy（可选 password）、create-application、create-stack、wait-for-deployment、deploy-application、deploy-environment、rollback-deployment、set-password-protection、detect-local-framework、detect-framework、detect-local-git、list-repo-directories、read-project-config、write-project-config
应用与环境	list-applications、get-application、get-application-status、get-formatted-list、get-formatted-status、update-application、rename-application、move-application、delete-application、list-environments、get-environment、create-environment、update-environment、delete-environment、set-scaling、get-environment-metrics、get-environment-activity、get-environment-runtime、list-folders、create-folder、delete-folder
日志与部署	get-environment-logs、list-deployments、get-deployment、get-build-logs
变量与域名	set-environment-variables、get-environment-variables、add-custom-domain、get-custom-domain-status、retry-custom-domain、remove-custom-domain
数据库	list-databases、get-database、create-database、update-database、delete-database、get-database-connection-string、rotate-database-password、get-database-schema、query-database、get-database-metrics、dump-database、import-database
套餐与账单	get-billing、list-plans、choose-plan、add-payment-method、payment-method-status、remove-payment-method、get-usage、get-usage-history、list-invoices、get-invoice、retry-invoice、get-outstanding-invoices、get-usage-alerts、set-usage-alerts、get-billing-details、set-billing-details
工作区与成员	create-workspace、list-members、invite-member、remove-member、set-member-role、list-roles、list-api-keys、create-api-key（付费套餐）、revoke-api-key
Git 提供商	get-github-installation-status、get-github-install-url、list-github-installations、list-repositories、list-branches、check-repo-access、connect-git-provider（GitLab / Bitbucket，一个链接）、list-provider-repositories
其他	list-notifications、mark-notifications-read、contact-support、ping、get-platform-config、get-cloudrun-config，以及底层上传步骤（package-source、request-upload-url、complete-upload、create-application-from-upload）

提示词：deploy-from-scratch — 会询问仅凭文件夹无法确定的两项信息（工作区，以及公开还是受密码保护），然后进行部署并返回 URL。

关闭 Agent

控制台中的“设置” →“安全” → Agents & CLI 决定此服务、CLI 和 VS Code 扩展可以在账户上执行哪些操作：先是一个总开关，然后是各组开关（部署、删除、设置、数据库、账单、工作区、API 密钥）。始终允许读取操作。后端会根据会话自身的客户端声明强制执行限制，该声明在会话签发时固定，因此无法通过请求头绕过；而且只能从控制台更改此开关。拒绝操作时会返回 AGENT_ACCESS_DISABLED 或 AGENT_ACTION_BLOCKED，并指出更改位置；服务的指令会告知助手不要重试。

身份验证

有两种接入方式；两者都会将凭据存储在 ~/.lightcloud/credentials.json 中。

connect（默认，适用于任何环境）。 让 Claude 使用你的电子邮箱进行连接。工具会显示一个 8 位代码和地址 console.light-cloud.com/device；在任意设备上打开该地址，如果你已有账户就登录（如果没有，请点击我们发送的电子邮件中的链接——批准后会创建账户），输入代码并批准。Claude 会调用 connect-status，直到审批完成。绝不会在 Claude 中输入密码。

login（在此计算机上的浏览器中）。 像以前一样，通过本地回环回调打开控制台的登录页面。

套餐与升级

每个工作区都从 Free 开始：每月包含价值 $1 的用量、无限量静态站点、3 个服务器应用，无需银行卡。Free 套餐的 $1 用完后，服务器应用和部署会暂停，直到下一个周期；静态站点会继续提供服务；Free 工作区绝不会产生账单。付费套餐（Lite、Starter、Pro、Business；list-plans 中列有价格和限制）包含价值等同于套餐价格的用量，额外用量会计入下一张账单，并且可以在结账时设置用量上限。按年付费可免费获得两个月。

升级只需一步。choose-plan（按年付费时设置 interval: "year"）会从已保存的银行卡扣款，或者返回一个 Stripe Checkout 链接，通过该链接可同时填写银行卡信息并完成首笔付款。助手会提供链接（“打开此链接以添加银行卡；Stripe 确认后，套餐会立即切换”），而 payment-method-status 会等待套餐切换完成。add-payment-method 仅用于保存或更换银行卡。银行卡号不会经过服务器。

Agent 可处理的拒绝

触及套餐限制的写入工具会返回一个 code 和一行 Next step:。套餐限制拒绝（PLAN_ENTITLEMENT）会指出包含被拒绝操作的套餐及其价格，例如 Next step: call the choose-plan tool with plan_id lite (Lite, $5/month) once the user agrees；由于 choose-plan 会收取费用，助手会在升级前征求用户同意。其他拒绝包括：PAYMENT_METHOD_REQUIRED → add-payment-method、POOL_EXHAUSTED → choose-plan（Free 套餐包含的用量已用完）、ORGANISATION_SUSPENDED → add-payment-method。deploy-from-scratch 提示词会引导用户完成整个流程：连接、检查账单、检测、创建、配置数据库和环境变量，以及部署。

有些拒绝需要通过与用户沟通来处理：

代码	触发条件	Agent 的处理方式
DOMAIN_NOT_POINTING_HERE	add-custom-domain 将替换一个正在为访客提供服务、但 DNS 指向其他位置的域名	告知用户需要添加哪条记录。只有用户表示仍要切换时，才使用 force: true 重试
USE_DOMAIN_ROUTES	向 update-application / update-environment 提供了不同的自定义域名	使用 add-custom-domain 或 remove-custom-domain
PAYMENT_FAILED	choose-plan 尝试从已保存的银行卡扣款，但银行卡被拒；套餐保持不变	告知用户；使用 add-payment-method 和 plan_id 保存另一张银行卡，保存后套餐即会切换

自定义域名随付费套餐提供。在 Free 套餐中，add-custom-domain 会因 PLAN_ENTITLEMENT 被拒绝，并指出包含自定义域名的套餐。Free 工作区上已有的域名会在所有者收到电子邮件 14 天后暂停（网站仍可通过其 light-cloud.io 地址访问）；届时，留在 Free 套餐上的数据库也会停止运行，但数据会保留；升级到付费套餐后，两者都会恢复。在仍有数据库时降级到 Free 会因 DATABASES_ON_FREE 被拒绝，直到数据库被删除。Free 套餐上的页面会带有一个小型 “by Light Cloud” 链接，该链接在边缘端添加；list-plans 会说明哪些套餐会显示该链接。

配置

无需配置。服务器默认通过以下地址连接 Light Cloud：

变量	默认值
LIGHT_CLOUD_API_URL	https://api.light-cloud.com
LIGHT_CLOUD_CONSOLE_URL	https://console.light-cloud.com

仅当你收到不同的端点地址时才设置这些变量。

开发

# Clone the repository
git clone https://github.com/light-cloud-com/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

测试

手动测试服务：

npm run build
node dist/index.js

然后通过 stdin 发送 JSON-RPC 消息。

许可证

MIT - 参见 LICENSE

链接

• Light Cloud Platform
• MCP 文档
• 报告问题

提交至 Anthropic 目录

软件目录政策的要求及相关内容所在位置：

• 打包文件：位于最新版本中的 .mcpb；源代码在此代码库中。
• 每个工具都应有工具注释（title、readOnlyHint、`destructiveHint）；描述应与实际行为一致；不得包含隐藏指令。
• 隐私政策：https://www.light-cloud.com/legal/privacy-policy · 支持：https://www.light-cloud.com/contact · 文档：https://docs.light-cloud.com/deploy-with-ai/mcp-server
• 示例提示词：“将我连接到 Light Cloud，我的邮箱是 [email protected]”“将此项目部署到 Light Cloud”“添加 Postgres 数据库，并在 production 上设置 DATABASE_URL”“上次部署为何失败？检查日志”。
• 包含示例数据的测试账号：在提交表单中提供。