mcpField
M
mcloud-projects

mcloud-projects

github.com/medusajs云与 DevOps2341.3k 次安装1 周前更新
代码仓库

关于 mcloud-projects

该技能介绍如何通过 `mcloud projects` 命令管理 Cloud 项目，涵盖项目列表、详情查询，以及不可逆删除的安全处理。

主要功能

  1. 01按组织列出项目
  2. 02按 ID 或 handle 查询项目
  3. 03通过确认保护项目删除
  4. 04查看项目状态和部署区域

适用场景

  1. 01检查组织中的项目
  2. 02查询项目关联的仓库和环境
  3. 03确认项目身份后将其删除

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/medusajs/medusa-agent-skills --skill mcloud-projects

安装后在 Claude Code 中输入/mcloud-projects确认已加载。

详细介绍

Cloud CLI：项目命令

执行 mcloud projects 命令以管理 Cloud 项目。

限制

  • projects delete 不可撤销 — 会移除所有关联环境、部署和资源。删除前务必确认项目 ID/句柄。
  • 在非交互式环境（脚本、流水线、Agent）中使用 delete 时，请添加 --yes。

命令

projects list

列出组织中的项目。如果省略 --organization（且未设置活动上下文组织），则会列出你有权访问的所有组织中的项目，并按组织分组。

mcloud projects list --organization <org-id> --json

选项：

  • -o/--organization <id> — 组织 ID（回退到活动上下文；如果未设置，则列出你所有组织中的项目）
  • --json — 以 JSON 格式输出
projects get

根据项目 ID 或句柄检索单个项目。

mcloud projects get <project-id-or-handle> --organization <org-id> --json

参数：

  • project — 项目 ID 或句柄（必填）

选项：

  • -o/--organization <id> — 组织 ID（回退到活动上下文；必填）
  • --json — 以 JSON 格式输出
projects delete

根据项目 ID 或句柄删除项目。不可撤销。

mcloud projects delete <project-id-or-handle> \
  --organization <org-id> \
  --yes

参数：

  • project — 项目 ID 或句柄（必填）

选项：

  • -o/--organization <id> — 组织 ID（回退到活动上下文；必填）
  • -y/--yes — 跳过确认提示（非交互模式下必填）
  • --json — 以 JSON 格式输出

项目字段（JSON）

字段说明
id项目 ID
handleURL 安全的项目句柄（大多数命令中使用）
name显示名称
status状态正常时为 ready
region部署区域（例如 us-east-1）
repository关联的 GitHub 仓库（owner/repo）
root_path仓库内的根路径
organization所属组织（id、name、created_at）
environments关联环境数组（每项可能包含 storefront_environments）

示例

# List all projects in an organization
mcloud projects list --organization org_123 --json

# Set context to a project by name
PROJECT_HANDLE=$(
  mcloud projects list --organization org_123 --json \
    | jq -r '.[] | select(.name == "My Store") | .handle'
)
mcloud use --project "$PROJECT_HANDLE"

# Get project details including environments
mcloud projects get my-store --organization org_123 --json

# List all environment handles for a project
mcloud projects get my-store --organization org_123 --json \
  | jq -r '.environments[].handle'

# Find project handle by name
mcloud projects list --organization org_123 --json \
  | jq -r '.[] | select(.name == "My Store") | .handle'

# Delete a project (irreversible — confirm before running)
mcloud projects delete old-project --organization org_123 --yes

评论

支持 Markdown