MCP 服务器

Cloudzero Model Context Protocol Server

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

README

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

从大型语言模型 (LLM) 中与 Cloudzero 中的云成本数据进行交互。

可以询问有关成本数据的问题，例如绘制月度差异图：

月度差异

工作原理

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

graph LR
    %%{init: {'theme':'neutral'}}%%
    %% 定义节点
    A[MCP 主机]
    B[本地 MCP 服务器]
    C[CloudZero API]
    D[(云成本数据)]

    %% 定义连接
    A -->|JSON-RPC 2.0| B
    B -->|HTTP/JSON| C
    C <--> D

    subgraph CloudZero_SaaS
    C
    D
    end

    subgraph Background_process
    B
    end

    subgraph Claude_Desktop
    A
    end

    subgraph Local_Machine
    Claude_Desktop
    Background_process
    end

    %% 定义样式
    classDef client padding:10px
    classDef server padding:10px
    classDef api padding:10px
    classDef db padding:10px

    %% 应用样式
    class A client
    class B server
    class C api
    class D db

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

该服务器实现了几个特定于 CloudZero 的工具：

get_costs：从 start_date 到 end_date 获取账单数据
get_dimensions：获取账单维度
list_budgets：列出预算
list_insights：列出洞察

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

设置

安装 Claude Desktop：

安装 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"
      ]
    }