Cloudzero MCP

🚀 クラウドゼロモデルコンテキストプロトコル（MCP）サーバー

大型言語モデル（LLM）を使用して、Cloudzeroのクラウドコストデータと対話できます。 コストデータに関する質問を行い、例えば月次の差異を描画することができます。

🚀 クイックスタート

このサーバーを使用することで、Claude Desktopを通じてCloudZeroのクラウドコストデータに関する質問を行い、可視化することができます。

✨ 主な機能

• 大型言語モデルを介してCloudZeroのクラウドコストデータにアクセス
• 特定の期間の請求データを取得
• 請求の次元を取得
• 予算と洞察をリストする

🔧 技術詳細

仕組み

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 バックグラウンドプロセス
    B
    end

    subgraph Claude_Desktop
    A
    end

    subgraph ローカルマシン
    Claude_Desktop
    バックグラウンドプロセス
    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を使用してリクエストと応答を行います。

📦 インストール

必要なソフトウェアのインストール

1. Claude Desktop をインストールします。
2. uv をインストールします。

プロジェクトの依存関係の設定

uv init
uv sync

APIキーの生成と設定

1. CloudZero API key を生成します。
2. .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を再起動すると、サーバープロセスがバックグラウンドで起動します。エラーが表示される場合があり、ログを確認して問題を調査することができます。 エラーがない場合は、「利用可能なクラウド請求ツールは何ですか」と質問して、リストを確認してみてください。

詳細な情報は Claude Desktop MCP ドキュメント を参照してください。

💻 使用例

基本的な使用法

Claude Desktopを起動し、MCPサーバーを設定した後、CloudZeroのクラウドコストデータに関する質問を行うことができます。 例えば、「月次の差異を描画してください」と質問すると、以下のような画像が表示されます。

高度な使用法

特定の期間の請求データを取得する場合は、get_costs ツールを使用します。

# ここに具体的なコード例があれば記載する

🔧 デバッグ

デバッグするために、対話型GUI付きのMCP開発サーバーを実行することができます。

uv run mcp dev server.py

これにより、Claude Desktopを繰り返し再起動することなく、コード内のエラーを調査することができます。