vantage-mcp-server

Vantage MCP サーバー

Vantage MCPサーバーについて

Vantage MCPサーバーは、Go言語で書かれたオープンソースツールで、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
  • MCP または全体的な Vantage エクスペリエンスに関するフィードバックを Vantage チームに送信する簡単な方法です。

はじめる

前提条件

ソースからインストールする場合は、次のパッケージがインストールされていることを確認してください (正確なバージョンについては.tool-versions参照してください)。

• 行く
• Node.js

これらの依存関係をインストールするには、バージョン マネージャー (例: asdf ) またはパッケージ マネージャー (例: Homebrew ) を使用できます。

また、読み取り専用のVantage APIトークンを作成する必要があります（書き込みは現時点では機能しません）。Vantage APIドキュメントの指示に従ってください。MCPサーバー専用の新しい読み取り専用APIトークンを作成することをお勧めします。

インストール

Homebrewの使用

ソースから

1. このリポジトリをクローンします。

2. サーバーを構築し、権限を調整します。

📝注: リポジトリから新しい変更をプルダウンする場合は、必ずgo buildを再実行してサーバーを再構築し、最新バージョンが実行されていることを確認してください。

3. MCP インスペクターを使用してデバッグします。

MCPクライアントの設定

セットアップ手順は、使用するMCPクライアントによって異なります。例としては、以下のクライアントが挙げられます。

• デスクトップ版クロード
• カーソル
• ガチョウ

利用可能なクライアントの一覧については、 MCPドキュメントをご覧ください。Claude for Desktop、Cursor、Gooseの詳細な手順については、以下をご覧ください。

デスクトップ版クロード

1. Claude for Desktopをダウンロードしてください。
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 サーバーで使用可能なツールが表示されます。
8. 設定が完了したら、Claude にプロンプトを送信できるようになります。新しいツールを使用するたびに、Claude は続行する前に承認を求めます。

カーソル

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. Gooseをダウンロードしてください。
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という名前の新しい変数を追加し、値を Vantage API トークンに設定します。
9. ［追加］をクリックします。

MacOSユーザーへの注意

GitHubページからリリースをダウンロードした際に、「開発者が確認できないため」実行ファイルが実行できない場合は、システム設定を開いて「プライバシーとセキュリティ」セクションを見つけてください。一番下までスクロールすると、「vantage-mcp-server-macos」がブロックされたというメッセージが表示されるので、「このまま開く」ボタンをクリックしてください。この手順の後、実行ファイルは問題なく実行できるはずです。

寄稿ガイドライン

このプロジェクトに貢献したい場合は:

1. このリポジトリをフォークします。
2. 新しいブランチを作成します: git checkout -b feature/my-feature 。
3. 変更を加えます。
4. コードがフォーマットされ、きれいにビルドされることを確認します。
5. プルリクエストを送信します。

コミュニティからの貢献、改善、バグ修正を歓迎します。問題が発生した場合は、このリポジトリのGitHub Issuesからバグレポートを送信してください。

ライセンス

商用および非商用のライセンスの詳細については、 LICENSE.MDファイルを参照してください。