vantage-mcp-server

Vantage MCP Server

Über den Vantage MCP Server

Der Vantage MCP Server ist ein Open-Source-Tool, das in Golang geschrieben ist und Ihnen die Interaktion mit Ihren Cloud-Kostendaten über KI-Assistenten und MCP-Clients ermöglicht. Als Brücke zu den bestehenden APIs von Vantage ermöglicht der Vantage MCP Server die Abfrage von Cloud-Ausgabendaten in natürlicher Sprache und gestaltet die Kostenanalyse intuitiver.

📝 Hinweis: Derzeit ist der Vantage MCP-Server nur als lokal ausgeführter Dienst mit Standard Input/Output (stdio) Transport verfügbar, d. h. er muss auf Ihrem Computer oder Server ausgeführt und in einen MCP-Client integriert werden.

Verfügbare Tools

Der Vantage MCP-Server stellt derzeit die folgenden Tools bereit, die von jedem kompatiblen MCP-Client (z. B. Claude, Cursor, Goose) aufgerufen werden können:

• query-costs
  • Eine allgemeine Möglichkeit, Kostendaten mit VQL abzurufen.
• list-costs
  • Zeigen Sie alle Kosten in einem zugehörigen Kostenbericht an.
• list-cost-reports
  • Listen Sie alle verfügbaren Kostenberichte auf.
• get-cost-report-forecast
  • Listen Sie alle Ausgabenprognosen im Zusammenhang mit einem Kostenbericht auf.
• list-cost-integrations
  • Listen Sie alle verfügbaren Kostenanbieterintegrationen (z. B. AWS, Azure, GCP) auf, um Kostendaten und die zugehörigen Konten bereitzustellen.
• list-cost-providers
  • Liste nur der Anbieter, die der angegebene Arbeitsbereich mit ihm geteilt hat.
• list-cost-services
  • Listet alle Dienste und die zugehörigen Anbieter auf, die mit dem angegebenen Arbeitsbereich geteilt werden.
• list-budgets
  • Listen Sie alle verfügbaren Budgets auf, um sie mit einem Kostenbericht zu vergleichen und die Ausgaben zu verfolgen.
• list-dashboards
  • Listen Sie alle im Vantage-Konto erstellten Dashboards auf.
• list-tags
  • Listen-Tags, die zum Filtern von Kostenberichten verwendet werden können.
• list-tag-values
  • Listen-Tag-Werte, die zum Filtern von Kostenberichten verwendet werden können.
• list-anomalies
  • Listen Sie Anomalien auf, die in Kostenberichten erkannt wurden.
• list-cost-providers
  • Listen Sie Kostenanbieter auf, die zum Filtern von Kosten in VQL-Abfragen verwendet werden können.
• list-unit-costs
  • Rufen Sie die Stückkosten für einen bestimmten Kostenbericht ab.
• get-myself
  • Ein Dienstprogramm zum Auflisten verfügbarer Arbeitsbereiche und Überprüfen der Zugriffsebene Ihres Authentifizierungstokens.
• submit-user-feedback
  • Eine einfache Möglichkeit, dem Vantage-Team Feedback zum MCP oder zur allgemeinen Vantage-Erfahrung zu senden.

Erste Schritte

Voraussetzungen

Wenn Sie aus der Quelle installieren, stellen Sie sicher, dass die folgenden Pakete installiert sind (die genauen Versionen finden Sie unter .tool-versions ):

• Gehen
• Node.js

Sie können einen Versionsmanager (z. B. asdf ) oder Paketmanager (z. B. Homebrew ) verwenden, um diese Abhängigkeiten zu installieren.

Sie müssen außerdem ein schreibgeschütztes Vantage-API-Token erstellen (Schreiben funktioniert derzeit nicht). Folgen Sie den Anweisungen in der Vantage-API-Dokumentation . Wir empfehlen die Erstellung eines brandneuen schreibgeschützten API-Tokens zur ausschließlichen Verwendung mit dem MCP-Server.

Installation

Homebrew verwenden

Aus der Quelle

1. Klonen Sie dieses Repository.

2. Erstellen Sie den Server und passen Sie die Berechtigungen an.

📝 Hinweis: Wenn Sie neue Änderungen aus dem Repository herunterladen, führen Sie go build unbedingt erneut aus, um den Server neu zu erstellen und sicherzustellen, dass Sie die neueste Version ausführen.

3. Debuggen Sie mit dem MCP-Inspektor.

MCP-Clients einrichten

Die Einrichtungsanweisungen variieren je nach verwendetem MCP-Client. Beispiele für Clients:

• Claude für Desktop
• Cursor
• Gans

Eine Liste der verfügbaren Clients finden Sie in der MCP-Dokumentation . Detaillierte Anweisungen für Claude für Desktop, Cursor und Goose finden Sie weiter unten.

Claude für Desktop

1. Laden Sie Claude für Desktop herunter.
2. Klicken Sie oben in Claude für Desktop auf Claude > Einstellungen (Tastaturkürzel Command + , ).
3. Wählen Sie im linken Menü des Einstellungsbereichs Entwickler aus.
4. Klicken Sie auf Konfiguration bearbeiten . Eine Konfigurationsdatei wird erstellt unter:

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

5. Öffnen Sie die Datei claude_desktop_config.json und aktualisieren Sie deren Inhalt. Ersetzen Sie die Platzhalter <path_to_compiled_vantage_mcp_server_binary> durch den Pfad, in den Sie die Vantage MCP Server-Binärdatei heruntergeladen haben, und <personal_vantage_api_token> durch Ihr Vantage API-Token.
   { "mcpServers": { "Vantage": { "command": "<path_to_compiled_vantage_mcp_server_binary>", "args": [], "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" } } } }
6. Speichern Sie die Konfigurationsdatei und starten Sie Claude neu.
7. Klicken Sie in der unteren rechten Ecke des Eingabefelds „Claude für Desktop“ auf das Hammersymbol, um die verfügbaren Tools für den Vantage MCP-Server anzuzeigen.
8. Sobald Sie die Konfiguration eingerichtet haben, können Sie Claude zur Eingabe auffordern. Jedes Mal, wenn Sie ein neues Tool verwenden, fragt Claude Sie um Ihre Zustimmung, bevor er fortfährt.

Cursor

1. Cursor herunterladen.
2. Öffnen Sie Cursor und klicken Sie in der Menüleiste auf Cursor > Einstellungen > Cursoreinstellungen .
3. Wählen Sie im linken Bereich MCP aus.
4. Klicken Sie auf „Neuen globalen MCP-Server hinzufügen“ .
5. Aktualisieren Sie den Inhalt der geöffneten Datei mcp.json . Ersetzen Sie die Platzhalter <path_to_compiled_vantage_mcp_server_binary> durch den Pfad, in den Sie die Vantage MCP Server-Binärdatei heruntergeladen haben, und <personal_vantage_api_token> durch Ihr Vantage API-Token.
   { "mcpServers": { "Vantage": { "command": "<path_to_compiled_vantage_mcp_server_binary>", "args": [], "env": { "VANTAGE_BEARER_TOKEN": "<personal_vantage_api_token>" } } } }

Gans

1. Laden Sie Goose herunter.
2. Öffnen Sie Goose und klicken Sie in der Menüleiste auf Goose > Einstellungen (Tastaturkürzel Command + , ).
3. Klicken Sie im Abschnitt „Erweiterungen “ auf „Benutzerdefinierte Erweiterung hinzufügen“ .
4. Geben Sie im ID -Feld vantage-mcp-server .
5. Geben Sie im Feld Name Vantage ein.
6. Geben Sie im Feld Beschreibung Query costs and usage data abfragen ein.
7. Geben Sie im Befehlsfeld den Pfad zur Binärdatei des Vantage MCP-Servers ein.
8. Fügen Sie im Abschnitt „Umgebungsvariablen“ eine neue Variable mit dem Namen VANTAGE_BEARER_TOKEN und dem auf Ihr Vantage-API-Token festgelegten Wert hinzu.
9. Klicken Sie auf Hinzufügen .

Hinweis für MacOS-Benutzer

Wenn Sie eine Version von unserer Github-Seite herunterladen und die ausführbare Datei nicht ausgeführt werden kann, weil der Entwickler nicht verifiziert werden kann, öffnen Sie bitte Ihre Systemeinstellungen. Suchen Sie dort den Abschnitt „Datenschutz und Sicherheit“. Scrollen Sie anschließend nach unten. Dort sollten Sie die Meldung sehen, dass „vantage-mcp-server-macos“ blockiert wurde. Klicken Sie auf „Trotzdem öffnen“. Danach sollte die ausführbare Datei problemlos ausgeführt werden können.

Beitragsrichtlinien

Wenn Sie zu diesem Projekt beitragen möchten:

1. Forken Sie dieses Repository.
2. Erstellen Sie einen neuen Zweig: git checkout -b feature/my-feature .
3. Nehmen Sie Ihre Änderungen vor.
4. Stellen Sie sicher, dass Ihr Code sauber formatiert und erstellt wird.
5. Senden Sie eine Pull-Anfrage .

Wir freuen uns über Community-Beiträge, Verbesserungen und Fehlerbehebungen. Sollten Sie auf Probleme stoßen, senden Sie uns bitte einen Fehlerbericht über die GitHub Issues dieses Repositorys.

Lizenz

Einzelheiten zu kommerziellen und nicht-kommerziellen Lizenzen finden Sie in der Datei LICENSE.MD .