vantage-mcp-server

Vantage MCP 服务器

关于 Vantage MCP 服务器

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

📝注意：目前，Vantage MCP 服务器仅可作为使用标准输入/输出 (stdio) 传输的本地运行服务使用，这意味着它必须在您的机器或服务器上执行并与 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
  • 仅列出给定工作区与其共享的提供程序。
• list-cost-services
  • 列出与给定工作区共享的所有服务及其相关提供程序。
• list-budgets
  • 列出所有可用的预算，以便与成本报告进行比较并跟踪支出。
• list-dashboards
  • 列出在 Vantage 帐户中创建的所有仪表板。
• list-tags
  • 列出可用于过滤成本报告的标签。
• list-tag-values
  • 列出可用于过滤成本报告的标签值。
• list-anomalies
  • 列出在成本报告中检测到的异常。
• list-cost-providers
  • 列出可用于过滤 VQL 查询中的成本的成本提供商。
• list-unit-costs
  • 检索给定成本报告的单位成本。
• get-myself
  • 用于列出可用工作区并检查授权令牌的访问级别的实用程序。
• submit-user-feedback
  • 向 Vantage 团队发送有关 MCP 或整体 Vantage 体验的反馈的简单方法。

入门

先决条件

如果您从源代码安装，请确保安装了以下软件包（有关确切版本，请参阅.tool-versions ）：

• 去
• Node.js

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

您还需要创建一个 Vantage API 的只读令牌（目前暂不支持写入）。请按照Vantage API 文档中的说明操作。我们建议您创建一个全新的只读 API 令牌，专供 MCP 服务器使用。

安装

使用 Homebrew

来自源

1. 克隆此存储库。

2. 搭建服务器并调整权限。

📝注意：如果您从存储库中提取新的更改，请务必重新运行go build以重建服务器并确保您运行的是最新版本。

3. 使用 MCP 检查器进行调试。

设置 MCP 客户端

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

• 克劳德桌面版
• 光标
• 鹅

请参阅MCP 文档，了解可用的客户端列表。下文提供了 Claude 桌面版、Cursor 和 Goose 的详细说明。

克劳德桌面版

1. 下载Claude 桌面版。
2. 在 Claude for Desktop 的顶部，单击Claude > 设置（键盘快捷键Command + , ）。
3. 在“设置”窗格的左侧菜单中，选择**“开发人员”** 。
4. 单击**“编辑配置”** 。配置文件创建于：

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

5. 打开claude_desktop_config.json文件并更新其内容。请确保将占位符<path_to_compiled_vantage_mcp_server_binary>替换为下载 Vantage MCP Server 二进制文件的路径，并将<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>" } } } }
6. 保存配置文件并重新启动Claude。
7. 在 Claude for Desktop 输入框的右下角，单击锤子图标即可查看 Vantage MCP Server 可用的工具。
8. 配置完成后，您就可以开始提示 Claude 了。每次使用新工具时，Claude 都会先征求您的同意，然后再继续操作。

光标

1. 下载光标。
2. 打开 Cursor，然后从菜单栏中单击Cursor > Settings > Cursor Settings 。
3. 在左侧窗格中，选择MCP 。
4. 单击**“添加新的全局 MCP 服务器”** 。
5. 更新已打开的mcp.json文件的内容。请确保将占位符<path_to_compiled_vantage_mcp_server_binary>替换为您下载 Vantage MCP Server 二进制文件的路径，并将<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>" } } } }

鹅

1. 下载Goose 。
2. 打开 Goose，然后从菜单栏中单击Goose > 设置（键盘快捷键Command + , ）。
3. 在扩展部分下，单击添加自定义扩展。
4. 在ID字段中，输入vantage-mcp-server 。
5. 在名称字段中，输入Vantage 。
6. 在描述字段中，输入Query costs and usage data 。
7. 在命令字段中，输入 Vantage MCP 服务器二进制文件的路径。
8. 在环境变量部分，添加一个名为VANTAGE_BEARER_TOKEN的新变量，并将值设置为您的 Vantage API 令牌。
9. 单击**“添加”** 。

MacOS 用户须知

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

贡献指南

如果你想为这个项目做出贡献：

1. 分叉此存储库。
2. 创建一个新分支： git checkout -b feature/my-feature 。
3. 做出更改。
4. 确保您的代码格式化并清晰地构建。
5. 提交拉取请求。

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

执照

有关商业和非商业许可的详细信息，请参阅LICENSE.MD文件。