# @google-cloud/observability-mcp 中文文档

规范地址：https://npmcn.com/package/%40google-cloud/observability-mcp/

版本：0\.2\.3
npm 元数据更新时间：2026-02-11T15:29:11.058Z
中文译文更新时间：2026-11-16T19:59:16.390Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40google-cloud/observability-mcp
原文对照：https://npmcn.com/package/%40google-cloud/observability-mcp/?lang=original
项目主页：https://github.com/googleapis/gcloud-mcp#readme
源码仓库：https://github.com/googleapis/gcloud-mcp

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

- 包体积（解压后）：1.5 MB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：6 个
- 首次发布：2025-09-09T17:39:52.832Z
- 最新版本发布：2026-02-11T15:29:10.936Z
- 近 30 天下载量：255414（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 3 个）

## 中文简介

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

## 安装

```sh
npm install @google-cloud/observability-mcp
```

也可以使用：`pnpm add @google-cloud/observability-mcp`、`yarn add @google-cloud/observability-mcp`、`bun add @google-cloud/observability-mcp`

## README

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

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

> 欲进一步了解基本服务,请参见正式文件:
> 
> -   [云记录](https://cloud.google.com/logging/docs)
> -   [云监测](https://cloud.google.com/monitoring/docs)
> -   [云迹](https://cloud.google.com/trace/docs)
> -   [报告错误](https://cloud.google.com/error-reporting/docs)

## 开始

关于先决条件和设置指示,请参见 [根读取](https://npmcn.com/package/README.md#-getting-started)。 。 。 .

### 认证

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

```shell
# 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](https://cloud.google.com/sdk/gcloud/reference/auth/application-default/set-quota-project):

```shell
# 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产品. 这个 不包括在内 [谷歌云服务条款](https://cloud.google.com/terms)。 。 。 . 当 MCP 规格、 其他 SDK 或 当其他溶液出现时可能断裂 和产品改变。 也见我们的 [安全政策](https://npmcn.com/package/SECURITY.md)。 。 。 .

## 捐款

请读我们的 [贡献指南](https://npmcn.com/package/CONTRIBUTING.md) 要开始.

## 许可证

该项目根据Apache 2.0许可证颁发许可——见 [自由主义](https://npmcn.com/package/LICENSE) 详细文件.

## 常见问题

### @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 和提交记录判断。

