@google-cloud/observability-mcp

中文文档
0.2.3发布于 2026/02/11Apache-2.0ES Module近 30 天下载 25.5万

用于GCP环境的MCP服务器,用于与各种可观测性API互动.

中文使用文档
文档目录7 节
  1. 开始
  2. 认证
  3. 使用量
  4. 工具参考
  5. 重要笔记
  6. 捐款
  7. 许可证

谷歌云可观测性 MCP 服务器 QQ

此服务器连接 示范背景协议(MCP) 客户端( 如 页:1 双子座CLI)去云来 可观察性 API 搜索日志、查看度量、返回痕迹和查看出错 报告。 它充当当地桥梁,翻译自然语言命令 从您的 CLI 到相应的 API 呼叫帮助您 理解、处理和解决问题 您的谷歌云环境 .

欲进一步了解基本服务,请参见正式文件:

开始

关于先决条件和设置指示,请参见 根读取。 。 。 .

认证

您需要认证两次:一次为您的用户账户,一次为应用程序本身.

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
# This allows the MCP server to securely make Google Cloud API calls on your behalf.
gcloud auth application-default login

设定配额项目

此服务器的所有 API 请求都需要一个 Google Cloud 工程 收费和API配额管理。 这被称为"quota项目". 这个 工程可能已经设置在gcloud CLI 中 。 选定为 配额项目需要您想要在可观察性中使用的 API 启用 或者在试图使用相关工具时会看到出错(例如:. 您需要使用配额计划中的 Cloud 日志 API 列表 log intries 工具).

如果您需要控制用于配额的项目,请执行以下命令(https://cloud.google.com/sdk/gcloud/reference/auth/application-default/ set-quota-project 互联网档案馆的存檔,存档日期2013-12-02:

# Set the project to be used for API quotas and billing by ADC
gcloud auth application-default set-quota-project YOUR_QUOTA_PROJECT_ID

这确保了从此服务器中所有的API使用都归于正确的工程.

使用量

服务器配置完毕后,您可以询问您的MCP客户端自然语言问题,询问您的Google Cloud环境. 以下是几个例子:

  • "给我看所有的日志 严重错误。"
  • "我的GCE事件在最后一小时的平均CPU利用率是多少?"
  • "记录过去30分钟的所有痕迹"
  • "最后一天我的日志里有没有新的堆栈痕迹?"

您的MCP客户端将把这些问题翻译为适当的工具呼叫,从Google Cloud获取数据.

工具参考

服务器曝光以下工具:

服务工具说明
日志list_log_entries列出一个项目的日志条目.
list_log_names列出项目日志名称 .
list_buckets列出项目日志桶 .
list_views列出项目日志视图.
list_sinks列出一个项目的日志汇.
list_log_scopes列出项目日志范围.
监测list_metric_descriptors列出一个项目的参数描述符.
list_time_series列出给定度量的时间序列数据.
list_alert_policies列出项目中的提醒政策.
追踪list_traces在项目中搜索痕迹 .
get_trace在一个项目中获得一个特定的追踪.
报告错误list_group_stats列出工程的错误组.

重要笔记

此寄存器正在预览中, 可能看到断开的更改 。 这个 仓库提供了一个解决方案,而不是官方支持的Google产品. 这个 不包括在内 谷歌云服务条款。 。 。 . 当 MCP 规格、 其他 SDK 或 当其他溶液出现时可能断裂 和产品改变。 也见我们的 安全政策。 。 。 .

捐款

请读我们的 贡献指南 要开始.

许可证

该项目根据Apache 2.0许可证颁发许可——见 自由主义 详细文件.

版本与发布记录

@google-cloud/observability-mcp 共发布 7 个版本,首次发布于 2025/09/10;过去 12 个月发布了 3 个版本。

版本发布日期距今
0.2.3latest2026/02/119 个月前
0.2.22026/01/0610 个月前
0.2.12025/12/1611 个月前
0.2.02025/11/141 年前
0.1.22025/09/301.1 年前
0.1.12025/09/111.2 年前

关于 @google-cloud/observability-mcp 的常见问题

@google-cloud/observability-mcp 是什么?

用于GCP环境的MCP服务器,用于与各种可观测性API互动.

如何安装 @google-cloud/observability-mcp?

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

@google-cloud/observability-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/google-cloud__observability-mcp 是否存在。

@google-cloud/observability-mcp 支持 ESM 还是 CommonJS?

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

@google-cloud/observability-mcp 可以商用吗?

@google-cloud/observability-mcp 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@google-cloud/observability-mcp 的下载量有多少?

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

@google-cloud/observability-mcp 还在维护吗?

最新版本 0.2.3 发布于 2026/02/11(9 个月前);至今共发布 7 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/09/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。