# @cloudgrid-io/mcp 中文文档

规范地址：https://npmcn.com/package/%40cloudgrid-io/mcp/

版本：0\.22\.5
npm 元数据更新时间：2026-11-09T16:30:55.536Z
中文译文更新时间：2026-11-10T03:58:58.844Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cloudgrid-io/mcp
原文对照：https://npmcn.com/package/%40cloudgrid-io/mcp/?lang=original
项目主页：https://github.com/cloudgrid-io/mcp
源码仓库：https://github.com/cloudgrid-io/mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4 MB，554 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19
- 运行依赖：7 个
- 首次发布：2026-06-04T07:34:27.447Z
- 最新版本发布：2026-11-09T16:30:55.073Z
- 近 30 天下载量：2786（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：141（近 12 个月 141 个）

## 中文简介

MCP访问 CloudGrid – 用户的应用程序与所需的基础设施一起运行的活运行时环境 : 管理 MongoDB, Redis (cache/queues/pub-sub),一个 pgvector 商店, 持续磁盘, 内置的AI 没有 API 密钥, 在任意 l

## 安装

```sh
npm install @cloudgrid-io/mcp
```

也可以使用：`pnpm add @cloudgrid-io/mcp`、`yarn add @cloudgrid-io/mcp`、`bun add @cloudgrid-io/mcp`

## README

# @cloudgrid-io/ mcp (英语)

CloudGrid的MCP服务器. 它暴露出"CloudGrid"行动作为MCP工具.

它从一个密码基地分出两版

-   **当地( stdio)** 运行在您的机器上, 完整的工具箱, 包括 CLI 包装 工具。 这个读取器覆盖它。 Claude Code, Cursor, Claude Desktop (英语).
-   **网络(托管的 HTTP)** - 更轻的工具箱(17个直接API工具,无CLI) claude.ai等网络客户端的包装. 见 [升级.md](https://npmcn.com/package/%40cloudgrid-io/mcp/REMOTE.md)。 。 。 .

本地版本将 `grid` 用于认证操作的 CLI( CLI) 处理认证、网格上下文和错误格式),并直接调用 API 插件、登录和能见度工具.

## CLI 兼容性

MCP仅在满足平台层时使用已安装的 CLI (单位:千美元)`MIN_CLI_VERSION`,目前为0.15.26 — 与API的现场直播紧紧相接 `cli_compat` 地板,它拒绝使用HTTP 426的更古老的CLI)。 地板下面 跳过本地/ 全球 CLI 并懒取 `@cloudgrid-io/cli@latest` 通过 npx转而使用. A CI 漂流后卫(`npm run test:drift-guard`(a) 声称 包裹动词存在于 CLI 帮助中.

### `GRID_AUTH_STALE` 超出范围

严格的OIDC( org- ownersed) 网格可以返回 `GRID_AUTH_STALE` 当召人的时候 会话在SSO政策变化之前。 MCP没有针对此类网格和 不处理此代码: 如果 `GRID_AUTH_STALE` 反应被看到,点 在 Console SSO 重新认证的用户 —— MCP 将不会默默地重试 .

## 先决条件

安装并登录到 CLI :

```
npm install -g @cloudgrid-io/cli
grid login
```

服务器没有直接读取证书 。 它运行 `grid`,使用自己的 证书存储于 `~/.cloudgrid/credentials`。 。 。 .

## 运行

```
npx -y @cloudgrid-io/mcp
```

或者来自克隆人:

```
cd mcp
npm install
npm start
```

它说MCP比Studio强. 指向任何 MCP 客户端 `cloudgrid-mcp` 命令.

### 每个客户端有一个 CloudGrid 服务器

运行此本地( stdio) 服务器—— 独立或通过 Claude 代码 插件, 将它捆绑在一起 —— 或主机连接器 (`mcp.cloudgrid.io`(a) 内 给定客户端。 从来没有两者:每个 `grid_*` 工具出现两次,两个服务器分别持有登录状态(本地 版本共享 CLI 的 `~/.cloudgrid/credentials`;连接符持有 他们可以不同意你是否在 然后,模型可以对最后回答的哪一个采取行动。 如何辨别: 重复 `grid_*` 客户端工具列表中的条目, 或客户端中的两个 CloudGrid 服务器 MCP/连接器设置. 要保存的 : 本地版, 无论您在哪里建立 文件夹中的运行时应用程序( 它有) `path` + CLI; 在 仅限聊天的客户端,用于发布单页.

### QA 会话日志( 可选)

设定 `CLOUDGRID_QA_SLACK_WEBHOOK` 改为: **内部/私人** 黑进网 URL 接收每个会话的 QA 日志(`log-<Client>-<transport>-mcp.txt`当a 本地( stdio) 会话启动、 失败或废弃 。 木头带着 用户的第一个消息(当主机转发它时)和身份细节,所以 目标频道必须是内部的。 主机版从不发布会话日志 完全可以(它的服务器不带网络hook); 主机 `grid_note` 已归档 CloudGrid API取而代之——见下文"隐私政策". 取消 —— 特性是完全黑暗的(没有捕获,没有) (已公布). `CLOUDGRID_QA_IDLE_MS` 覆盖已放弃的窗口( 默认) 900 000 = 15分钟.

## 工具

登记了38个工具(两个版本共有15个工具,仅23个本地工具)。 无有堕取别名. MIN CLI VERSION:0.15.26 (英语).

### 直接API工具(两版)

| 工具 | 环绕 | 内容提要 |
| --- | --- | --- |
| `grid_pickup` | API 密码 | 捡起一个应用程序: 让你的 OWN COPY 从任何你能看到的应用程序中(像一分叉) 进入一个你可以构建的网格. |
| `grid_pull` | API 密码 | 在 PLACE 中继续/编辑一个应用程序 `git clone` 中, 包含 :. |
| `grid_collab` | API 密码 | 让PUSH Accesss进入别人拥有的同一实体——你成为该实体上的合作者,不... |
| `grid_create_grid` | API 密码 | 为登录用户创建一个新的网格(工作空间)——它们成为其管理员. |
| `grid_note` | API 密码 | 留下一个段落摘要,说明您创建了这个会话,以及为什么,对于本地版的可选QA会话日志... |
| `grid_plug` | API 密码 | 将一个应用程序,网站,游戏,或HTML页面插入到CloudGrid在公共现场URL中. |
| `grid_get_app_source` | API 密码 | 获取 CurRENT 已部署的 HTML 作为文本的灵感/放入线程, 这样您就可以编辑它并重新插入 SAME URL... |
| `grid_visibility` | API 密码 | 改变谁可以看到 CloudGrid 灵感 OR 运行时的应用/代理 . |
| `grid_check_deploy` | API 密码 | 请检查aync runtime-app构建(一个部署,这里指插件)是否完成,该应用是否为活化. |
| `grid_list_grids` | API 密码 | 列出登录用户的网格,每个网格都包含有swit,名称,角色,以及提供状态. |
| `grid_start` | API 密码 | 与 CloudGrid 一起构建的简短方向: 本次会话的帐号被签为及其活动网格, 如何... |
| `grid_get_template` | 实体 | 装入特定的 CloudGrid 工作流程,模板,示例,规则,排除出故障的注释,或按名称引用 doc——readermi... |
| `grid_report` | API 密码 | 向CloudGrid团队报告真正的CloudGrid失败——只有用户明确同意. |
| `grid_hello` | API 密码 | 创建最低限度的问候页面并插入用户的网格,还原活的URL. |
| `grid_delete` | `grid delete entity` | 存档 CloudGrid 灵感 . |

直接的API工具将平台称为没有CLI的平台,所以它们也在工作 网页版. `grid_login` 写同样 `~/.cloudgrid/credentials` 页:1 CLI使用,所以两者共享一个身份.

### CLI 包装工具(仅当地版)

| 工具 | 环绕 | 内容提要 |
| --- | --- | --- |
| `grid_login` | API 密码 | 启动无CLI"CloudGrid"登录. |
| `grid_login_status` | API 密码 | 完成网格 login启动的登录 . |
| `grid_create_project` | `grid new` | 脚手架新的 CloudGrid app或代理文件夹(cloudgrid.yaml + a web service),可选的预声明资源. |
| `grid_view_logs` | `grid logs` | 一个实体的尾端日志 . |
| `grid_share` | `grid visibility set` | 设置一个实体的能见度并打印其URL. |
| `grid_feedback` | `grid feedback list` | 列出当前网格的最近反馈事件 . |
| `grid_whoami` | `grid whoami` | 显示已签名的用户和活动的网格 . |
| `grid_switch_grid` | `grid use` | 切换活动网格. |
| `grid_logout` | `grid logout` | 签署并清除当地证书. |
| `grid_status` | `grid status` | 网格仪表板 实体细节 或部署快照. |
| `grid_info` | `grid info` | 显示 CloudGrid 实体的元数据 . |
| `grid_get` | \`网格得到 <网格' | 实体 |
| `grid_describe_grid` | `grid describe grid <slug> --json` | 显示一个网格的细节:角色,成员,空格,分级,通配符-TLS状态. |
| `grid_edit_existing_app` | `grid pull` | 继续/编辑本地的 EXISTING 实体: 下载其源代码 + yungrid. yaml 并链接文件夹, 所以您的下个 \`grid... |
| `grid_rename` | `grid rename` | 重命名 CloudGrid 实体的显示名( slug 不变) . |
| `grid_take_offline` | `grid unplug` | 取一实体出网. |
| `grid_rollback_deploy` | `grid rollback` | 回滚一个实体到上一个版本. |
| `grid_list_versions` | `grid versions` | 为一个实体列出已出版的版本. |
| `grid_set_env` | `grid env` | 管理一个实体的环境变量. |
| `grid_set_secret` | `grid secrets` | 设置或列出实体的秘密名称. |
| `grid_scaffold` | `grid scaffold` | Scaffold 服务文件夹在 yaml (idempotent) 中宣告. |
| `grid_diagnose` | `grid doctor` | 运行 CloudGrid 本地环境诊断. |
| `grid_get_url` | `grid open --print` | 为实体返回公共 URL . |

`grid_share` 财务报告和审定财务报表 `grid_visibility` 目的重叠 : `grid_share` 将 CLI 和默认值包成 `link`· ; `grid_visibility` 是直接API, 使用一个 明确范围,并默认其目标为会议最后的下降——这是其中之一 网络版得到.

所有工具都带有MCP说明(`readOnlyHint`, (中文(简体) ), `destructiveHint`, (中文(简体) ), `openWorldHint`对支持他们的客户.

## 测试

烟雾测试让服务器有一个真正的 MCP 客户端, 列出工具,并呼叫 仅读 `grid_feedback` 工具结束到结束 :

```
cd mcp
npm install
npm run smoke
```

它需要一个登录的CLI `$PATH`。 。 。 .

### 现场烟雾剧本

又有3个剧本在索要时与活API相对抗. 他们不是中情局的成员. 新的插头需要签入,所以它们都没有产生匿名投放. 每一个 跳过一个步骤,并说为什么,当该步骤需要的变量缺失时. 托肯斯只来自环境,从未被印出.

| 脚本 | 没有秘密 | 带着秘密 |
| --- | --- | --- |
| `npm run smoke:drop` | 使用 `anon: true` 返回时 `needs_auth` 并发表什么. | `CLOUDGRID_TOKEN` (和 `CLOUDGRID_SMOKE_GRID` 如果账户有多个网格:一个已签名的创建者会发布一个自有的页面及其URL服务. |
| `npm run smoke:redrop` | 同样的签出检查,通过网页版. | `CLOUDGRID_SMOKE_REDROP_ENTITY_ID` + 键 `CLOUDGRID_SMOKE_REDROP_OWNER_TOKEN` (或 `CLOUDGRID_SMOKE_REDROP_OWNER_TOKEN_FILE`) 对于已存在的匿名投放:编辑更新到位,没有签入. 每次编辑时都会重新考虑所有者代币;用新鲜的代币文件会重写. |
| `npm run smoke:claim` | 跳过. | `CLOUDGRID_TOKEN`:一个签入的插头. 添加 `CLOUDGRID_SMOKE_CLAIM_ENTITY_ID` + 键 `CLOUDGRID_SMOKE_CLAIM_TOKEN` 用于当前匿名投放 : `grid_pull` 把它记入账户 一滴可以申请一次. |

任何发布请求在服务器内拒绝签名退出检查 所以随时可以安全运行.

## 设计

-   贝壳出来 `execFile` 和各种争论,故无壳和无壳 注射表面.
-   `grid_view_logs` 从不使用 `--follow`连线电话都回不来了.
-   无国籍者。 每一次通话都是引用CLI的.

## 隐私政策

完全政策: [https://cloudgrid.io/privacy (英语)](https://cloudgrid.io/privacy)

### MCP 服务器对您的数据所做的

**鉴定.** `grid_login` 打开基于浏览器的 Google 登录流 CloudGrid的API (英语:`/auth/login`) (中文(简体) ). 返回的JWT存储于 `~/.cloudgrid/credentials` 与 `0600` 权限—— CLI 和 MCP 共享 设计一个证书文件( a)`auth.js:7-8`) (中文(简体) ). 网页版没有登录 工具: AI 工具与 OAuth 的连接符符号, 此服务器会自行发行 短暂的进入标志, 与 CloudGrid 会话封在里面, 所以 语句从未交给 AI 工具.

**部署.** `grid_plug` 上传您的应用文件( HTML, 源代码, 资产) 到 `https://api.cloudgrid.io/api/v2/plug`。上传前,内入源是 扫描已知的 API- key 模式( OpenRouter, Anthropic, OpenAI, Google, GitHub, AWS, Slack, Strape; 一个匹配挡住部署. 这不是保证 ——一个坚定的模型可以混淆扫描过后的一个密钥——但它阻止了 诚意的"嵌入它所以它的工作"路径。 认证信头(Bearer JWT,网格流)是 附以识别打电话者.

**报告错误 .** `grid_report` 发送错误报告到 `https://api.cloudgrid.io/api/v2/errors`。工具描述指示 模式仅在用户明确同意的情况下使用,并设置 `CLOUDGRID_TELEMETRY=off` 无条件禁用它,但不存在 在报告处理者本身进行方案同意检查。 有效载荷包括: 错误摘要、 诊断元数据( 平台、 节点版本、 传输), 一面旗帜 记录用户是否同意分享对话(`deploy.js:544`, (中文(简体) ), (单位:千美元) `context` 模型供应——按其申报形状 (单位:千美元)`register.js:964-975`)可以携带失败的输入(例如 HTML 或 args)和原始请求. 笔录本身不是由这个工具发送的. 报告擦洗是 **双层**价值和 `message` 字段扫描 用于已知的秘密形状( API 密钥前缀, 如 `sk-ant-`, (中文(简体) ), `sk-proj-`, (中文(简体) ), `AKIA…`; JWTs; PEM 私有密钥块; 熊熊符; 基本- 自动 URL 证书)和相匹配物替换为 `[REDACTED]`任意或 未知形状的秘密, 与已知模式不符 无所修行. 客户端的刷新( U)`scrubReportContext` + 键 `scrubSecretValues` 在 POST 中运行; 服务器端点应用服务器侧 顶上键名过滤器。 瞒秨厨秈ㄓ 页:1 `message` 或者说 `context` 您发送或设置 `CLOUDGRID_TELEMETRY=off` 改为 完全禁用报告 .

**版本检查.** 启动时, 本地版会请求 `https://registry.npmjs.org/@cloudgrid-io/mcp/latest` 以检测 stale `.mcpb` 安装,从不自动更新。 它不发送账户数据和用户内容. 主机版不这样做.

**QA会话日志.** 何时 `CLOUDGRID_QA_SLACK_WEBHOOK` 设置(默认取消, 否则,本地(stdio)服务器会将每个会话的QA日志发布到一个 内部Slack频道关于部署,出错,闲置超时,或处理关闭. 这个 日志包括:会话元数据(用户名、电子邮件、网格流、客户名) 用户的第一个消息( 被擦去, 上限为 2 000 个字符), 每个工具调用线索 仅使用允许列表的参数键,并通过 `grid_note` 或者说 `grid_plug`是因为 `session_note` (封顶为4000个字符). 第一个信息是 抓获的 `CLOUDGRID_USER_REQUEST` 环境变量(由 Claude代码)或 `grid_plug`是因为 `user_request` 参数(仅本地版). **主机版没有自己寄出去**页:1 `grid_plug` 没有 `user_request` 或者说 `session_note`,则没有插件、闲置或 关闭。 一个主机是 `grid_note`,用户要求的: 给 CloudGrid API 的注释`/api/v2/feedback`在用户自己的登录下, 有网格流和客户名——没有电子邮件地址,没有工具调用线索, 谈话没别的了,签了就回来了 `needs_auth` 财务报告和审定财务报表 发送什么. `grid_report` (两版) 向 CloudGrid API 仅在用户同意后:消息和上下文模式 传出加客户名和平台, 谈话时才进行 明确同意这一点。 文本值 (第一个消息、叙述、工具参数和错误消息)通过 通过一个洗涤器,将 JWTs, PEM 键, 熊鼠标志, 和已知的 提供 API- key 格式。 身份字段( E)`_keyResult` 值和页眉 block)和结构化结果数据绕过文本洗涤器.

**此服务器没有收集其他数据 .** 服务器不跟踪使用情况 分析或传输超出上述流量和经认证的数据 CloudGrid API 调用单个工具制作(例如. `/grids`, (中文(简体) ), `/pickup`, (中文(简体) ), `/deploys`, (中文(简体) ), `/inspirations/{id}/source`. CLI 包装工具外壳 到云纹去 `grid` CLI, 共同拥有 `~/.cloudgrid/credentials` 文件,不通过 此服务器 。 他们更喜欢把CLI捆在 `.mcpb` 或兼容 `grid` 已经在你身上 `PATH`;如果两者均不在场或不够新,它们就会回到 `npx -y @cloudgrid-io/cli@latest` (单位:千美元)`cli.js:411-424`页:1 **下载和运行 npm 登记册中的CLI** (单位:千美元)`registry.npmjs.org`——软件 安装,以及能够到达 npm 的第二流(启动版本检查) 以上为第一个)。 平台层面的数据处理由链接覆盖 隐私政策.

## 常见问题

### @cloudgrid-io/mcp 是什么？

MCP访问 CloudGrid – 用户的应用程序与所需的基础设施一起运行的活运行时环境 : 管理 MongoDB, Redis \(cache/queues/pub-sub\),一个 pgvector 商店, 持续磁盘, 内置的AI 没有 API 密钥, 在任意 l

### 如何安装 @cloudgrid-io/mcp？

在项目目录运行 npm install @cloudgrid-io/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cloudgrid-mcp，可以用 npx cloudgrid-mcp 直接运行。

### @cloudgrid-io/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cloudgrid-io\_\_mcp 是否存在。

### @cloudgrid-io/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cloudgrid-io/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cloudgrid-io/mcp 可以商用吗？

@cloudgrid-io/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cloudgrid-io/mcp 的下载量有多少？

根据 npm 官方下载统计，@cloudgrid-io/mcp 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,786 次，日均约 93 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cloudgrid-io/mcp 还在维护吗？

最新版本 0\.22\.5 发布于 2026/11/10（今天）；至今共发布 141 个版本，其中过去 12 个月发布了 141 个；首次发布于 2026/06/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。