burkestar_cloudzero_mcp

burkestar_cloudzero_mcp

by burkestar
An MCP server that integrates CloudZero API for querying cloud cost data within Claude Desktop.

CloudZero Cost Data Integration for Claude

Overview

The CloudZero Cost Data Integration for Claude project enables users to interact with their cloud cost data in CloudZero using a Large Language Model (LLM) like Claude. This integration leverages the Model Context Protocol (MCP) server and the CloudZero v2 API to provide tools for querying and analyzing cloud cost data directly from Claude Desktop.

Key Features

  • Query Cloud Cost Data: Ask questions about your cloud costs, such as month-over-month differences.
  • Tool Calling: Implemented tools include get_costs, get_dimensions, list_budgets, and list_insights.
  • MCP Integration: Uses JSON-RPC 2.0 for communication between Claude Desktop and the MCP server.

How It Works

The MCP server acts as a bridge between Claude Desktop and the CloudZero API. Here’s a high-level overview of the process:

graph LR
    %%{init: {'theme':'neutral'}}%%
    %% Define nodes
    A[MCP Host]
    B[Local MCP Server]
    C[CloudZero API]
    D[(Cloud Costs Data)]

    %% Define connections
    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

    %% Define styles
    classDef client padding:10px
    classDef server padding:10px
    classDef api padding:10px
    classDef db padding:10px

    %% Apply styles
    class A client
    class B server
    class C api
    class D db
  1. Initialization: Claude Desktop sends an initialize request to the MCP server.
  2. Capability Negotiation: The server responds with its capabilities, including available tools.
  3. Tool Execution: Users can call specific tools to retrieve or analyze cloud cost data.

Setup

Prerequisites

Configuration

  1. Clone the repository and install dependencies:
    shell uv init uv sync

  2. Generate your CloudZero API key and add it to the .env file:
    env CLOUDZERO_API_KEY=YOUR_SECRET_KEY

  3. Install the MCP server into Claude Desktop:
    shell uv run mcp install server.py

  4. Edit claude_desktop_config.json to configure the MCP server:
    json "CloudZero": { "command": "/Users/USERNAME/.local/bin/uv", "args": [ "run", "--with", "mcp[cli]", "mcp", "run", "/Users/USERNAME/workspace/open_source/cloudzero-mcp/server.py" ] }

  5. Restart Claude Desktop to launch the MCP server.

Usage

Once the MCP server is running, you can interact with your cloud cost data directly from Claude Desktop. For example, ask:

  • "What tools are available for cloud billing?"
  • "Plot the month-over-month cost difference."

Which Tools Available

Debugging

For troubleshooting, you can run the MCP development server with an interactive GUI:

uv run mcp dev server.py

MCP Inspector

Resources

License

This project is licensed under the MIT License.

Features & Capabilities

Categories
mcp_server model_context_protocol python cloudzero claude api_integration cloud_cost_analysis

Implementation Details

View on GitHub

Stats

0 Views
1 GitHub Stars

Repository Info

burkestar Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI