优势-MCP服务器

Name: 优势-MCP服务器
Author: vantage-sh

作者：vantage-sh75 星标更新：2025-10-28

安装使用来源：spider==github.com

项目介绍

Vantage MCP 服务器

<h4>通过 MCP 客户端（如 Claude、Cursor 等）使用自然语言探索您组织的云成本。您可以查询您组织过去的和当前的云成本支出、成本标签、提供商集成等。</h4> <img src="static/img/MCP.png" alt="image" width="600" height="auto"> </div>

关于 Vantage MCP 服务器

Vantage MCP 服务器是一个开源工具，用 Go 语言编写，允许您通过 AI 助手和 MCP 客户端与您的云成本数据进行交互。作为 Vantage 现有 API 的桥梁，Vantage MCP 服务器让您能够使用自然语言查询云成本数据，并使成本分析更加直观。

📝 注意：Vantage MCP 服务器提供自托管和远程两种形式。此仓库支持自托管版本，它使用本地运行的标准输入/输出 (stdio) 传输。对于远程替代方案，请参阅 Vantage MCP 文档。

可用工具

目前，Vantage MCP 服务器公开了以下工具，这些工具可以被任何兼容的 MCP 客户端（例如 Claude、Cursor、Goose）调用：

query-costs
- 使用 VQL 获取成本数据的一般方法。
list-costs
- 显示关联的成本报告中的所有成本。
list-cost-reports
- 列出所有可用的成本报告。
get-cost-report-forecast
- 列出与成本报告相关的所有支出预测。
list-cost-integrations
- 列出所有可用的成本提供商集成（例如 AWS、Azure、GCP），并提供成本数据及其相关账户。
list-cost-providers
- 列出给定工作区共享的所有提供商，用于在 VQL 查询中过滤。
list-cost-services
- 列出所有服务及其相关提供商，这些服务已与给定的工作区共享。
list-budgets
- 列出所有可用于与成本报告比较并跟踪支出的预算。
list-dashboards
- 列出在 Vantage 账户中创建的所有仪表板。
list-tags
- 列出可用于过滤成本报告的标签。
list-tag-values
- 列出可用于过滤成本报告的标签值。
list-anomalies
- 列出在成本报告中检测到的所有异常。
list-unit-costs
- 检索给定成本报告的单位成本。
get-myself
- 一个列出可用工作区并检查您的身份验证令牌访问级别的实用程序。
submit-user-feedback
- 向 Vantage 团队发送关于 MCP 或整体 Vantage 经验反馈的简单方式。

开始使用

先决条件

如果您是从源代码安装，确保安装了以下包（请参见 .tool-versions 中的确切版本）：

Go
Node.js

您可以使用版本管理器（例如 asdf）或包管理器（例如 Homebrew）来安装这些依赖项。

您还需要创建一个只读的 Vantage API 令牌（写入功能暂时不可用）。请遵循 Vantage API 文档中的说明。我们建议为 MCP 服务器创建一个全新的只读 API 令牌。

安装

使用 Homebrew

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

从源代码

克隆此仓库。

git clone https://github.com/vantage-sh/vantage-m-服务器

构建服务器并调整权限。

go build -o vantage-mcp-server
chmod +x vantage-mcp-server

📝 注意：如果您从仓库拉取新更改，请务必重新运行 go build 来重建服务器并确保您正在运行最新版本。

使用 MCP 检查器进行调试。

npx @modelcontextprotocol/inspector -e VANTAGE_BEARER_TOKEN=<token> ./vantage-mcp-server

设置 MCP 客户端

设置说明因使用的 MCP 客户端而异。示例客户端包括：

请参阅 MCP 文档以获取可用客户端列表。以下是针对桌面版 Claude、Cursor 和 Goose 的详细说明。

桌面版 Claude

下载桌面版 Claude。
在桌面版 Claude 的顶部，点击 Claude > 设置（键盘快捷键 Command + ,）。
在设置面板的左侧菜单中，选择 开发者。
点击 编辑配置。会在以下位置创建一个配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

打开 claude_desktop_config.json 文件并更新其内容。确保替换占位符 <path_to_compiled_vantage_mcp_server_binary> 为您下载的 Vantage MCP 服务器二进制文件路径，以及 <personal_vantage_api_token> 为您自己的 Vantage API 令牌。
```
{
  "mcpServers": {
    "Vantage": {
      "command": "<path_to_compiled_vantage_mcp_server_binary>",
      "args": [],
      "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" }
    }
  }
}
```
保存配置文件并重启 Claude。
在桌面版 Claude 输入框右下角，点击锤子图标以查看 Vantage MCP 服务器的可用工具。
设置好配置后，您可以开始提示 Claude。每次使用新工具时，Claude 都会请求您的批准后再继续。

Cursor

下载 Cursor。
打开 Cursor 并从菜单栏点击 Cursor > 设置 > Cursor 设置。
在左侧窗格中，选择 MCP。
点击 添加新的全局 MCP 服务器。
更新打开的 mcp.json 文件的内容。确保替换占位符 <path_to_compiled_vantage_mcp_server_binary> 为您下载的 Vantage MCP 服务器二进制文件路径，以及 <personal_vantage_api_token> 为您自己的 Vantage API 令牌。
```
{
  "mcpServers": {
    "Vantage": {
      "command": "<path_to_compiled_vantage_mcp_server_binary>",
      "args": [],
      "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" }
    }
  }
}
```

Goose

下载 Goose。
打开 Goose 并从菜单栏点击 Goose > 设置（键盘快捷键 Command + ,）。
在扩展部分，点击 添加自定义扩展。
在 ID 字段中，输入 vantage-mcp-server。
在名称字段中，输入 Vantage。
在描述字段中，输入 查询成本和使用数据。
在命令字段中，输入 Vantage MCP 服务器二进制文件的路径。
在 环境变量 部分，添加一个名为 VANTAGE_BEARER_TOKEN 的新变量，并将其值设置为您自己的 Vantage API 令牌。
点击添加。

注意事项（适用于 macOS 用户）

如果您从我们的 GitHub 页面下载了一个发行版，但可执行文件因为“无法验证开发者”而无法运行，请打开您的系统设置。然后找到“隐私和安全”部分。向下滚动到底部，您应该会看到一条消息，说“vantage-mcp-server-macos”已被阻止，点击“仍然打开”按钮。完成这一流程后，可执行文件应该就可以正常运行了。

贡献指南

如果您想为此项目做出贡献：

分叉此仓库。
创建一个新的分支：git checkout -b feature/my-feature。
进行您的更改。
确保您的代码格式正确且构建无误。
提交一个拉取请求。

我们欢迎社区贡献、改进和错误修复。如果您遇到任何问题，请通过此仓库的 GitHub Issues 提交错误报告。

许可证

请参阅 LICENSE.MD 文件以了解商业和非商业许可详情。