Vantage优势MCP
语言类型:英语 翻译结果:优势-MCP服务器
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"Vantage": {
"args": [],
"command": "\u003cpath_to_compiled_vantage_mcp_server_binary\u003e",
"env": {
"VANTAGE_BEARER_TOKEN": "\u003cpersonal_vantage_api_token\u003e"
}
}
}
}
服务介绍
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以获取确切版本):
您可以使用版本管理器(例如asdf)或包管理器(例如Homebrew)来安装这些依赖项。
您还需要创建一个只读的Vantage API令牌(写入权限目前不可用)。请遵循Vantage API文档中的说明。我们建议专门为MCP服务器创建一个新的只读API令牌。
安装
使用Homebrew
bash
brew install vantage-sh/tap/vantage-mcp-server
从源代码安装
- 克隆此仓库。
bash
git clone https://github.com/vantage-sh/vantage-mcp-server
- 构建服务器并调整权限。
bash
go build -o vantage-mcp-server
chmod +x vantage-mcp-server
📝 注意:如果您从仓库拉取了新更改,请务必重新运行
go build以重建服务器,并确保您正在运行最新版本。
- 使用MCP检查器调试。
bash
npx @modelcontextprotocol/inspector -e VANTAGE_BEARER_TOKEN= ./vantage-mcp-server### 设置MCP客户端
设置说明根据您使用的MCP客户端而有所不同。示例客户端包括:
请参阅MCP文档以获取可用客户端列表。以下是关于Claude for Desktop、Cursor和Goose的详细设置说明。
Claude for Desktop
-
从Claude for Desktop顶部,点击 Claude > 设置(快捷键
Command + ,)。 -
在设置面板左侧菜单中,选择 开发者。
-
点击 编辑配置。将在以下位置创建一个配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%Claudeclaude_desktop_config.json
- macOS:
-
打开
claude_desktop_config.json文件并更新其内容。确保将占位符<path_to_compiled_vantage_mcp_server_binary>替换为您下载的Vantage MCP Server二进制文件路径,并将<personal_vantage_api_token>替换为您的Vantage API令牌。json
{
"mcpServers": {
"Vantage": {
"command": "<path_to_compiled_vantage_mcp_server_binary>",
"args": [],
"env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" }
}
}
} -
保存配置文件并重启Claude。
-
在Claude for Desktop输入框右下角,点击锤子图标查看Vantage MCP Server可用工具。
-
完成配置后,您可以开始与Claude进行交互。每次使用新工具时,Claude会在继续之前请求您的批准。
Cursor
-
下载Cursor。
-
打开Cursor,然后从菜单栏中点击 Cursor > 设置 > Cursor设置。
-
在左侧窗格中,选择 MCP。
-
点击 添加新的全局MCP服务器。
-
更新打开的
mcp.json文件的内容。确保将占位符<path_to_compiled_vantage_mcp_server_binary>替换为您下载的Vantage MCP Server二进制文件路径,并将<personal_vantage_api_token>替换为您的Vantage API令牌。json
{
"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 Server二进制文件的路径。
- 在 环境变量 部分,添加一个新的变量,名称为
VANTAGE_BEARER_TOKEN,值设置为您的Vantage API令牌。 - 点击 添加。
对于MacOS用户的注意事项
如果您从我们的GitHub页面下载了一个发布版本,但可执行文件因“无法验证开发者”而无法运行,请打开系统设置。然后找到“隐私与安全”部分。滚动到底部,您应该会看到一条消息,提示“vantage-mcp-server-macos”被阻止,点击“仍然打开”按钮。完成此流程后,可执行文件应能正常运行。
贡献指南
如果您希望为此项目做出贡献:
- 分叉此仓库。
- 创建一个新分支:
git checkout -b feature/my-feature。 - 进行更改。
- 确保您的代码格式正确且构建无误。
- 提交一个pull request。我们欢迎社区的贡献、改进和错误修复。如果您遇到任何问题,请通过此仓库的 GitHub Issues 提交错误报告。
许可
有关商业和非商业许可详情,请参阅 LICENSE.MD 文件。