Vertex Ai MCP Server

🚀 Vertex AI 頂点人工知能ガイド

Vertex AI は、機械学習モデルの構築とデプロイに使用される強力なプラットフォームです。このガイドでは、Vertex AI の様々なツールとサービスを活用して開発プロセスを最適化する方法を詳しく説明します。

🚀 クイックスタート

Vertex AI は、機械学習モデルの構築とデプロイに使用される強力なプラットフォームです。このガイドでは、Vertex AI の様々なツールとサービスを活用して開発プロセスを最適化する方法を詳しく説明します。

✨ 主な機能

• 基礎ツール：vertex-ai-cli は Vertex AI のコマンドラインインターフェイスで、核心的な操作を実行します。answer_query_websearch は Vertex AI を使ってウェブ検索と質問応答を行い、generate_code はコードスニペットを自動生成します。
• 高度な機能：モデルの微調整機能では、カスタムデータセットを使って Vertex AI モデルを微調整し、性能を向上させることができます。また、バッチ処理機能では大規模データの並列処理をサポートし、効率を向上させます。リアルタイム推論機能では、オンラインでモデル推論を実行し、即時の結果を取得できます。

📦 インストール

クイックインストール

以下のコマンドを使用して、Vertex AI CLI を迅速にインストールします。

bunx vertex-ai-cli --add

環境変数の設定

プロジェクトのルートディレクトリに .env ファイルを作成または編集し、以下の内容を追加します。

AI_PROVIDER=vertex  # 選択可能な値: vertex または gemini
GOOGLE_CLOUD_PROJECT=your_project_id  # 必須項目（AI_PROVIDER が vertex の場合）
GEMINI_API_KEY=your_gemini_api_key  # AI_PROVIDER が gemini の場合、必須
VERTEX_MODEL_ID=gemini-2.5-pro-exp-03-25  # オプション、デフォルト値は .env.example から
GEMINI_MODEL_ID=gemini-2.5-pro-exp-03-25  # 同上
GOOGLE_CLOUD_LOCATION=us-central1  # Vertex AI に固有の設定
AI_TEMPERATURE=0.0
AI_USE_STREAMING=true
AI_MAX_OUTPUT_TOKENS=65536  # デフォルトは .env.example から
AI_MAX_RETRIES=3
AI_RETRY_DELAY_MS=1000

💻 使用例

基本的な使用法

Vertex AI CLI を使って基本的な操作を行う例です。

bunx vertex-ai-cli --add

高度な使用法

Vertex AI を Cline と統合する高度なシナリオです。

1. clib.toml ファイルを開き、[mcpServers] の下に以下の内容を追加します。

[vertex-ai-server]
command = "bunx"
args = ["-y", "vertex-ai-cli"]
env = {
    AI_PROVIDER = "vertex",
    GOOGLE_CLOUD_PROJECT = "your_project_id",
    VERTEX_MODEL_ID = "gemini-2.5-pro-exp-03-25",
    AI_TEMPERATURE = "0.0",
    # その他の設定パラメータ...
}
alwaysAllow = ["answer_query_websearch"]
disabled = false

2. ファイルを保存すると、Cline が自動的に Vertex AI サービスを検出して起動します。

📚 ドキュメント

開発とデバッグ

監視モード

以下のコマンドを使用して、コードの変更をリアルタイムで監視します。

bun run watch

フォーマットと検証

コードのスタイルを統一するために、以下のコマンドを使用します。

bun run format
bun run lint

統合と拡張

Cline との統合

Vertex AI を Cline（強力なコマンドラインツール）に統合するには、以下の手順を実行します。

1. clib.toml ファイルを開き、[mcpServers] の下に特定の設定を追加します。
2. ファイルを保存すると、Cline が自動的に Vertex AI サービスを検出して起動します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については LICENSE ファイルを参照してください。