关键词

云成本分析AI集成Vantage数据查询自然语言界面费用管理

使用说明

项目简介

Vantage MCP 服务器是一个开源工具，用Golang编写，它作为 Vantage API 的桥梁，使您能够通过 AI 助手和兼容 MCP 的客户端，使用自然语言与您的云成本数据进行交互。您可以查询关于云花费、成本标签、提供商集成等信息，让成本分析更加直观。

目前，Vantage MCP 服务器主要支持通过标准输入/输出 (Stdio) 传输协议在本地运行，需要与一个 MCP 客户端配合使用。

主要功能点

Vantage MCP 服务器通过 MCP 协议向客户端暴露以下功能：

  • 查询成本数据: 支持按日期范围和使用 Vantage Query Language (VQL) 进行灵活过滤，获取详细的云成本明细。
  • 列出成本报告: 查看您在 Vantage 中已创建的所有成本报告列表及其基本信息，包括报告标题、过滤器和唯一标识符（token）。
  • 列出云服务商集成: 查看已配置的云服务提供商集成列表，了解可以从中获取成本数据的提供商类型（如 AWS, Azure, GCP）及其相关账户信息。
  • 列出标签: 获取可用于过滤成本和成本报告的标签（Tag）列表。
  • 列出标签值: 根据指定的标签键（Tag Key），查找该标签所有关联的值和提供商信息。
  • 列出成本异常: 查看在成本报告中检测到的异常情况，可按报告、服务、提供商等过滤。
  • 列出可用的云服务商: 获取可以在 VQL 查询中用于过滤的成本提供商列表。
  • 获取当前账户信息: 查看与当前 API Token 关联的账户信息，包括您有权限访问的 Workspace 列表。

安装步骤

前提条件

如果您选择从源代码安装，请确保已安装 Go 和 Node.js。建议使用如 'asdf' 或 Homebrew 等版本管理工具安装指定版本。

您还需要一个 只读 的 Vantage API Token。请根据 Vantage API 文档的指引创建，并强烈建议为此 MCP 服务器单独创建一个新的只读 Token。

使用 Homebrew 安装

在终端运行以下命令：

brew install vantage-sh/tap/vantage-mcp-server

从源代码安装

  1. 克隆仓库： 
    git clone https://github.com/vantage-sh/vantage-mcp-server
  2. 进入仓库目录，构建服务器程序并赋予执行权限： 
    cd vantage-mcp-server
go build -o vantage-mcp-server
chmod +x vantage-mcp-server

服务器配置

Vantage MCP 服务器通过 Stdio 协议运行，通常由 MCP 客户端直接启动并与之通信。因此，服务器本身的配置（如监听端口）是由客户端间接控制的。

您需要在使用的 MCP 客户端中配置 Vantage MCP 服务器的启动信息。典型的 MCP 客户端配置通常是一个 JSON 结构，包含：

  • 一个服务器的名称（例如 "Vantage"）。
  • 'command' 字段：指定 Vantage MCP 服务器可执行文件的完整路径。
  • 'args' 字段：一个字符串数组，用于向服务器传递启动参数（当前 Vantage MCP 服务器无需额外参数，此数组为空）。
  • 'env' 字段：一个键值对对象，用于设置服务器进程的环境变量。重要：您需要在此处设置 'VANTAGE_BEARER_TOKEN' 环境变量，其值就是您的只读 Vantage API Token。

具体的配置路径和格式因客户端而异，请参考您使用的 MCP 客户端（如 Claude for Desktop, Cursor, Goose）的官方文档。

基本使用方法

  1. 按照您的 MCP 客户端文档，在其配置中添加 Vantage MCP 服务器的启动信息，并填入正确的服务器程序路径和您的 Vantage API Token。
  2. 保存配置并重启您的 MCP 客户端。
  3. 在客户端界面中找到并激活 Vantage MCP 服务器提供的工具列表。
  4. 开始使用自然语言与客户端交互，询问关于您的云成本的问题。客户端会利用配置好的 Vantage MCP 服务器，通过调用相应的工具来获取数据并为您呈现答案。首次调用新工具时，客户端可能会要求您授权。

注意事项

  • 确保您的 Vantage API Token 具有所需的只读权限。
  • 对于 MacOS 用户，如果直接运行下载的二进制文件遇到“开发者无法验证”的提示，请前往“系统设置”->“隐私与安全性”，找到相关提示并点击“仍要打开”。

信息

分类

商业系统

访问项目