谷歌云可观测性 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许可证颁发许可——见 自由主义 详细文件.