Cloudzero Model Context Protocol Server

by burkestar
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports environment variable configuration through .env files for storing API keys and other sensitive configuration.

  • Supports rendering of Mermaid diagrams to visualize architecture and data flows between components.

Cloudzero 模型上下文协议 (MCP) 服务器

通过大型语言模型 (LLM) 与 Cloudzero 中的云成本数据进行对话。

询问有关成本数据的问题,例如绘制月度差异:

工作原理

使用CloudZero v2 API模型上下文协议MCP。

在 Claude Desktop 中配置 MCP 服务器后,它将在启动时作为后台进程启动。Claude Desktop 作为 MCP 主机,将向 MCP 服务器发送initiatize请求。服务器会以其功能进行响应,其中包括prompts和用于工具调用的tools

该服务器实现了 CloudZero 特有的几个工具:

  • get_costs获取从start_dateend_date账单数据
  • get_dimensions账单维度
  • list_budgets列出预算
  • list_insights列出见解

MCP 协议使用 JSON-RPC 2.0 进行请求和响应。

设置

安装Claude 桌面

安装uv

设置项目依赖项:

uv init uv sync

生成您的CloudZero API 密钥

使用以下命令编辑.env

CLOUDZERO_API_KEY=YOUR_SECRET_KEY

安装

要将 MCP 服务器安装到 Claude Desktop:

uv run mcp install server.py

编辑您的claude_desktop_config.json以设置uv命令的正确路径并更新您的USERNAME ,如下所示。

此配置文件位于 Claude Desktop 的Settings > Developer > Edit Config下。

"CloudZero": { "command": "/Users/USERNAME/.local/bin/uv", "args": [ "run", "--with", "mcp[cli]", "mcp", "run", "/Users/USERNAME/workspace/open_source/cloudzero-mcp/server.py" ] }

重启 Claude Desktop。桌面启动后,它会在后台启动服务器进程。您可能会看到错误,可以深入查看日志来查找问题所在。

如果没有错误,请尝试询问“有哪些可用于云计费的工具”以查看其列表。

有关更多信息,请参阅Claude Desktop MCP 文档

调试

为了进行调试,您可以运行带有交互式 GUI 的 MCP 开发服务器来检查:

uv run mcp dev server.py

这对于排除代码中的错误很有用,而无需不断重启 Claude Desktop。

-
security - not tested
A
license - permissive license
-
quality - not tested

该服务器允许用户通过大型语言模型使用自然语言查询和分析来自 Cloudzero 的云成本数据。

  1. How it works
    1. Setup
      1. Install
        1. Debug
          ID: cqk0mkff6v