存储 MCP 服务器 QQ
存储器 示范背景协议(MCP) 服务器使 AI 助手能够轻松地与 Google Cloud 存储器交互 桶和物品管理. 使用存储 MCP 服务器,您可以:
-
与Google云存储使用自然语言的互动. 说明 您想要的结果 而不是记忆复杂的命令语法、 旗帜和 参数.
-
自动化并简化复杂的工作流程. 链式多存储操作 变成一个单一的、可重复的命令,以减少手动努力和机会 错误.
-
为云存储管理降低出入口障碍. 授权团队 较不熟悉GCS的成员自信地采取强有力的行动 安全无虞.
-
在对象和桶上进行分析和汇总查询. 执行 使用 存储透视 数据集
-
运行高级过滤器并搜索您的数据 . 搜索和过滤对象 按文件类型、大小和其他元数据字段 存储透视 数据集
开始
先决条件
QQ 设置您的 MCP 服务器
双子星CLI和双子星代码辅助
将存储 MCP 服务器与双子座 CLI 或双子座代码辅助集成,运行 下面设置命令。 这将安装 MCP 服务器为 双子体 CLI 扩展 用于当前用户,并提供给您的所有项目.
npx @google-cloud/storage-mcp init --agent=gemini-cli
初始化过程后,您可以验证存储-mcp服务器是 通过运行以下命令正确配置 :
gemini mcp list
> ✓ gcs: npx -y @google-cloud/storage-mcp (stdio) - Connected
默认情况下,服务器只允许安全,无损的工具. 启用
可修改或删除现有数据的工具
--enable-destructive-tools 旗帜 :
npx @google-cloud/storage-mcp init --agent=gemini-cli --enable-destructive-tools
其他AI客户端
要与其他客户端一起使用存储 MCP 服务器, 请在他们的客户端中添加以下片段 各自的 JSON 配置文件 :
"gcs": {
"command": "npx",
"args": ["-y", "@google-cloud/storage-mcp"]
}
流行工具说明 :
- 克劳德桌面 : 打开 克劳德 > 设置 > 开发者 > 编辑配置 财务报告和审定财务报表
编辑
claude_desktop_config.json。 。 。 . - 线条 : 然后单击 MCP 服务器图标 配置 MCP 服务器 要编辑
cline_mcp_settings.json。 。 。 . - 光标 : 编辑
.cursor/mcp.json用于单一项目或~/.cursor/mcp.json所有项目. - 双子座 CLI( 人工设置 ):
如果不使用扩展名编辑
.gemini/settings.json用于单一项目或~/.gemini/settings.json页:1 所有项目.
对于 视觉工作室代码 编辑 .vscode/mcp.json 在工作空间中的文件
用于单个工程或您所有工程的全局用户设置文件:
"servers": {
"gcs": {
"command": "npx",
"args": ["-y", "@google-cloud/storage-mcp"]
}
}
地方发展
关于在当地安装寄存器的更多信息,请参见: 发展.md
测试
要运行集成或E2E测试,您需要设置
GOOGLE_CLOUD_PROJECT 或者说 GCP_PROJECT_ID 环境变量为有效
谷歌云项目ID.
export GOOGLE_CLOUD_PROJECT=your-gcp-project-id
npm run test:integration --workspace=packages/storage-mcp
npm run test:e2e --workspace=packages/storage-mcp
可用的 MCP 工具
存储 MCP 服务器提供两套工具: 安全工具 财务报告和审定财务报表 破坏性工具。默认情况下,只启用安全工具来防止 意外数据损失.
安全工具
安全工具只读或只创建新对象而不影响现有 这些。 它们永远不会修改或删除GCS中的现有数据.
| 工具 | 说明 |
|---|---|
list_buckets | 列出项目中的所有桶 . |
get_bucket_metadata | 获取特定桶的综合元数据 . |
get_bucket_location | 得到一个桶的位置. |
view_iam_policy | 查看IAM的一桶政策. |
check_iam_permissions | 测试IAM对一桶的许可. |
create_bucket | 创建新桶 。 如果桶已经存在, 则失败 . |
list_objects | 在 GCS 桶中列出对象. |
read_object_metadata | 读取特定对象的综合元数据. |
read_object_content | 读取特定对象的内容. |
write_object_new | 写入新对象。 如果对象已经存在, 则失败 . |
upload_object_new | 上传文件到新对象。 如果对象已经存在, 则失败 . |
copy_object_new | 复制对象到新目的地。 如果目的地已经存在, 则失败 . |
get_metadata_table_schema | 检查是否启用了 GCS 透视服务, 并返回给定的透视数据集配置的 BigQuery 表策略 . |
execute_insights_query | 执行针对透视数据集的大查询 SQL 查询并返回结果. |
list_insights_configs | 列出特定工程的所有存储透视数据集配置的名称. |
破坏性工具
警告: 这些工具可以永久地修改或删除已存在的数据. 启用 只有在你确信特工应该被允许表演时 这些行动.
你可以通过运行 init 命令与
--enable-destructive-tools 旗帜。 启用后,这些工具将取代其保险箱
(例如, write_object 已注册,而不是 write_object_new) (中文(简体) ).
| 工具 | 说明 |
|---|---|
delete_bucket | 删除 一个桶. |
update_bucket_labels | 修改 桶的标签. |
delete_object | 删除 从桶中取出特定物体. |
update_object_metadata | 修改 已存在的对象的自定义元数据. |
download_object | 下载对象, 覆盖 目标文件. |
move_object | 移动 对象(复制后删除正本). |
write_object | 写入对象, 覆盖 如果它已经存在. |
upload_object | 上传文件, 覆盖 目标对象. |
copy_object | 复制对象, 覆盖 目标对象. |
QQ MCP 权限
存储 MCP 的权限直接与权限相连 经认证的用户或服务账户。 限制权限和操作 最低特权原则,你可以 授权 gcloud 作为服务账户 并指定服务账户 a 带有有限权限的角色 谷歌云存储.
捐款
我们欢迎捐款! 无论是修复错误,共享反馈,还是 欢迎你们的贡献。 请读我们的 贡献指南 要开始.
德摩斯语
重要笔记
此寄存器正在预览中, 可能看到断开的更改 。 这个 寄存器提供了一个解决方案,而不是官方支持的Google产品. 当 MCP 规格、 其他 SDK 或 当其他溶液出现时可能断裂 和产品改变。 也见我们的 安全政策。 。 。 .