Cloudzero 모델 컨텍스트 프로토콜(MCP) 서버

대규모 언어 모델(LLM)을 통해 Cloudzero의 클라우드 비용 데이터와 대화하세요.

월별 차이를 표시하는 것과 같이 비용 데이터에 대해 질문해 보세요.

작동 원리

CloudZero v2 API 와 Model Context Protocol MCP를 사용합니다.

지엑스피1

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을 사용합니다.

Related MCP server: dbt Semantic Layer MCP Server

설정

Claude Desktop 설치 :

uv 설치

프로젝트 종속성을 설정하세요:

uv init
uv sync

CloudZero API 키를 생성하세요.

.env 다음과 같이 편집합니다.

CLOUDZERO_API_KEY=YOUR_SECRET_KEY

설치하다

Claude Desktop에 MCP 서버를 설치하려면:

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을 다시 시작하세요. Desktop이 시작되면 백그라운드에서 서버 프로세스가 시작됩니다. 오류가 표시될 수 있으며, 로그를 자세히 살펴보면 문제가 무엇인지 파악할 수 있습니다.

오류가 없다면 "클라우드 청구에 사용할 수 있는 도구는 무엇인가요?"라고 질문하여 나열된 도구를 확인해 보세요.

자세한 내용은 Claude Desktop MCP 문서를 참조하세요.

디버그

디버깅을 위해 대화형 GUI로 MCP 개발 서버를 실행하여 다음을 검사할 수 있습니다.

uv run mcp dev server.py

이 기능은 Claude Desktop을 계속해서 다시 시작하지 않고도 코드의 버그를 해결하는 데 유용합니다.