vantage-mcp-server

Vantage MCP-сервер

О сервере Vantage MCP

Vantage MCP Server — это инструмент с открытым исходным кодом, написанный на Golang, который позволяет вам взаимодействовать с данными о расходах в облаке через помощников AI и клиентов MCP. Выступая в качестве моста к существующим API Vantage, Vantage MCP Server позволяет вам запрашивать данные о расходах в облаке, используя естественный язык, и делает анализ расходов более интуитивным.

📝 Примечание: в настоящее время сервер 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
  • Простой способ отправить отзыв о MCP или общем опыте использования Vantage команде Vantage.

Начиная

Предпосылки

Если вы устанавливаете из исходного кода, убедитесь, что установлены следующие пакеты (точные версии см. в .tool-versions ):

• Идти
• Node.js

Для установки этих зависимостей вы можете использовать менеджер версий (например, asdf ) или менеджер пакетов (например, Homebrew ).

Вам также понадобится создать токен API Vantage только для чтения (запись в данный момент не работает). Следуйте инструкциям в документации API Vantage . Мы рекомендуем создать совершенно новый токен API только для чтения для эксклюзивного использования с сервером MCP.

Установка

Использование домашнего пива

Из источника

1. Клонируйте этот репозиторий.

2. Создайте сервер и настройте разрешения.

📝 Примечание: если вы скачали новые изменения из репозитория, обязательно повторно запустите go build чтобы пересобрать сервер и убедиться, что вы используете последнюю версию.

3. Отладка с помощью инспектора MCP.

Настройка клиентов MCP

Инструкции по настройке различаются в зависимости от того, какой клиент MCP вы используете. Примеры клиентов включают:

• Клод для рабочего стола
• Курсор
• Гусь

Список доступных клиентов см. в документации MCP . Подробные инструкции для Claude for Desktop, Cursor и Goose приведены ниже.

Клод для рабочего стола

1. Загрузите Claude для рабочего стола .
2. В верхней части Claude for Desktop нажмите Claude > Настройки (сочетание клавиш Command + , ).
3. В левом меню панели настроек выберите пункт Разработчик .
4. Нажмите Edit Config . Файл конфигурации создается по адресу:

• 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. Сохраните файл конфигурации и перезапустите Клода.
7. В правом нижнем углу поля ввода Claude for Desktop щелкните значок молотка, чтобы увидеть доступные инструменты для сервера Vantage MCP.
8. После настройки конфигурации вы можете начать запрашивать Клода. Каждый раз, когда вы используете новый инструмент, Клод будет спрашивать вашего одобрения, прежде чем продолжить.

Курсор

1. Скачать Курсор .
2. Откройте Курсор и выберите Курсор > Настройки > Настройки курсора в строке меню.
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. Скачать Гусь .
2. Откройте Goose и выберите Goose > Настройки в строке меню (сочетание клавиш Command + , ).
3. В разделе «Расширения» нажмите «Добавить пользовательское расширение» .
4. В поле ID введите vantage-mcp-server .
5. В поле Имя введите Vantage .
6. В поле Описание введите Query costs and usage data .
7. В поле «Команда» введите путь к двоичному файлу Vantage MCP Server.
8. В разделе «Переменные среды» добавьте новую переменную с именем VANTAGE_BEARER_TOKEN и значением, равным вашему токену API Vantage.
9. Нажмите Добавить .

Примечание для пользователей MacOS

Если вы загружаете релиз с нашей страницы Github и исполняемый файл не запускается «потому что разработчик не может быть проверен», откройте настройки системы. Затем найдите раздел «Конфиденциальность и безопасность». Затем прокрутите страницу вниз, и вы увидите сообщение о том, что «vantage-mcp-server-macos» заблокирован, нажмите кнопку «открыть в любом случае». После этого исполняемый файл должен запуститься без проблем.

Правила внесения вклада

Если вы хотите внести свой вклад в этот проект:

1. Сделайте форк этого репозитория.
2. Создайте новую ветку: git checkout -b feature/my-feature .
3. Внесите изменения.
4. Убедитесь, что ваш код отформатирован и построен правильно.
5. Отправьте запрос на извлечение .

Мы приветствуем вклад сообщества, улучшения и исправления ошибок. Если у вас возникнут какие-либо проблемы, отправьте отчет об ошибке через GitHub Issues этого репозитория.

Лицензия

Подробную информацию о коммерческом и некоммерческом лицензировании см. в файле LICENSE.MD .