Cloudzero MCP

🚀 雲零模型上下文協議（MCP）服務器

雲零模型上下文協議（MCP）服務器允許你通過大型語言模型（LLM）與 Cloudzero 的雲成本數據進行交互。你可以針對成本數據提出問題，例如繪製月度差異圖。

🚀 快速開始

基本使用

通過該服務器，你能方便地與 Cloudzero 的雲成本數據對話，提出如繪製月度差異圖等問題。

✨ 主要特性

• 數據交互：藉助大型語言模型與 Cloudzero 雲成本數據進行交互。
• 特定工具：實現了一些特定於 CloudZero 的工具，如 get_costs、get_dimensions、list_budgets 和 list_insights。
• 協議支持：使用 JSON - RPC 2.0 進行請求和響應。

📦 安裝指南

安裝依賴

1. 安裝 Claude Desktop。
2. 安裝 uv。
3. 設置項目依賴項：

uv init
uv sync

生成 API Key

生成 CloudZero API key。

配置環境變量

編輯 .env 文件如下：

CLOUDZERO_API_KEY=YOUR_SECRET_KEY

安裝 MCP 服務器

將 MCP 服務器安裝到 Claude Desktop 中：

uv run mcp install server.py

配置 Claude Desktop

編輯 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 文檔。

💻 使用示例

基礎用法

在配置好服務器並啟動後，你可以直接在 Claude Desktop 中詢問關於雲成本數據的問題，例如“有哪些可用的雲計費工具”。

高級用法

你可以使用服務器實現的特定工具進行更復雜的操作，如使用 get_costs 獲取從 start_date 到 end_date 的計費數據。

📚 詳細文檔

工作原理

使用 CloudZero v2 API 和 Model Context Protocol 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

一旦 MCP 服務器在 Claude Desktop 中配置完成，它將在啟動時作為背景進程啟動。Claude Desktop 作為 MCP 主機將發送一個 initiatize 請求到 MCP 服務器。服務器將響應其 功能，包括 prompts 和 tools 用於工具調用。

服務器實現的特定於 CloudZero 的工具如下：

• get_costs：獲取從 start_date 到 end_date 的計費數據。
• get_dimensions：獲取計費維度。
• list_budgets：列出預算。
• list_insights：列出洞察。

MCP 協議使用 JSON - RPC 2.0 進行請求和響應。

調試

為了調試，你可以運行帶有交互式 GUI 的 MCP 開發服務器來檢查：

uv run mcp dev server.py

這對於無需不斷重新啟動 Claude Desktop 即可排查代碼中的錯誤非常有用。