LocalCloud MCP：为编码智能体提供本地云工作流

MCP 指南与演练

发布于 2026 年 10 月 9 日阅读时长 6 分钟AI 编程智能体

为你的编程智能体提供一个免费的本地云环境，用于构建、测试和调试 Google Cloud 应用。MCP 提供服务、SDK 设置和诊断信息；你的应用针对本地运行时运行其集成测试。

安装与连接

安装 LocalCloud CLI 0.1.9 或更高版本，并确保 Docker 正在运行。使用 0.1.5 或更高版本的运行时，以获得经过验证的严格客户端工具 schema。在 macOS 上，或使用 Homebrew 的 Linux 上：

brew install LocalGCloud/tap/localcloud
lc --version
lc doctor
lc mcp install --client cursor

重新加载 Cursor 并启用 localcloud。桥接会自动启动或复用你的本地运行时。客户端指南还涵盖了 Claude Code/Desktop、Codex、VS Code、Cline、Gemini CLI、Antigravity 和 Windsurf，以及不使用 Homebrew 的安装方式。

A coding agent connects through MCP to LocalCloud; application tests use standard SDKs with discovered local endpoints.

给智能体一个任务

要求进行一个结果可观察的小型测试：

Use LocalCloud MCP to list local services, check readiness, and obtain SDK settings.
Check compatibility before writing a small Cloud Storage, Pub/Sub, and BigQuery integration test.
Use only the returned local endpoints and uniquely named test resources.
Assert the actual results and clean up only resources created by the test.
Stop if a required operation is unavailable; do not fall back to real Google Cloud.

智能体从 localcloud_list_services、localcloud_check_readiness 和 localcloud_get_env 开始。返回的 SDK 设置会考虑运行时的实际端口映射，因此测试不会猜测端点或请求真实的云凭据。

三个云工作流

Cloud Storage：创建一个唯一命名的存储桶，上传一个已知字符串，将其读回，并检查内容是否完全一致。
Pub/Sub：创建一个主题和订阅，发布一条已知消息，拉取并验证其字节，然后确认该消息。
BigQuery：运行 SELECT 1 AS mcp_smoke，并检查结果是否恰好包含一行且值为 1。

这些断言通过标准 Google Cloud SDK 来检验应用行为。该示例在清理时会删除自己创建的存储桶、主题和订阅。阅读工作流指南以获取各个智能体提示词。

运行示例

为这三个服务启动一个独立的运行时。动态端口使其能够与你日常使用的环境并行运行：

lc start --image agentcloud/localcloud:0.1.5 \
  --data-volume localcloud-mcp-demo \
  --services gcs,pubsub,bigquery --local-only --accept-dynamic-ports

从公共 CLI 仓库中，使用 uv 运行该示例及其可选的 Python SDK 依赖：

git clone https://github.com/LocalGCloud/localcloud-cli.git
cd localcloud-cli
uv run --with mcp==2.0.0 --with google-cloud-storage \
  --with google-cloud-pubsub --with google-cloud-bigquery \
  examples/mcp_workflows.py --data-volume localcloud-mcp-demo

通过 CLI 0.1.9 和完整的打包运行时 0.1.5 候选版本所演示的结果为：

PASS MCP: localcloud_list_services
PASS MCP: localcloud_check_readiness
PASS MCP: localcloud_check_compatibility
PASS MCP: localcloud_get_diagnostics
PASS MCP: SDK configuration validates against its output schema
PASS MCP: BigQuery query returns the expected row
PASS Cloud Storage: upload and read back the exact content
PASS Pub/Sub: publish, pull, verify, and acknowledge
PASS BigQuery: SELECT 1 returns the expected row
Cleanup complete: only uniquely named example resources were removed

完成后，使用 lc stop --data-volume localcloud-mcp-demo 停止示例运行时。其命名卷仍可供复用。

诊断故障

将失败的断言交给智能体，并让它在更改测试之前检查就绪状态、诊断信息和最近的请求。某个服务可能出现在目录中，但在运行环境中处于禁用状态；请使用其当前的就绪状态和兼容性记录。

如果现有运行时早于 0.1.5，请遵循运行时升级和故障排除说明。更新 CLI 或安装另一个客户端配置不会替换现有容器。

本地数据与验证

上述 SDK 工作流已通过已发布的 macOS ARM64 CLI 和完整的 Linux ARM64 运行时镜像，未挂载源代码或 JAR 覆盖层。此本地证据与 Google Cloud 生产环境的一致性以及在各平台上的验证是分开的。

使用测试自有的资源并显式清理。默认数据卷是共享的；逻辑项目不是智能体之间的安全边界。当你需要独立运行时，请选择单独的命名卷。MCP 管理写入和破坏性操作需要显式的运行时权限设置。

MCP 设置指南 · 更多 SDK 示例 · CLI 源代码与发布版本