WEPPY

Gemini CLI設定

Gemini CLIでRoblox MCPを使用する方法。

Google Gemini CLIでRoblox MCPを使用する方法です。

前提条件

  1. Node.js(v18.0.0以上)

    node --version
  2. Gemini CLI インストール済み

    npm install -g @google/gemini-cli
  3. Roblox Studioプラグイン インストール完了

MCPサーバーの登録

方法1: CLIコマンド(推奨)

ターミナルで1行で登録できます:

gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp

--trust フラグはツール呼び出しのたびに確認プロンプトをスキップします。

グローバル設定として登録するには -s user を追加してください:

gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp

方法2: 設定ファイルの編集

.gemini/settings.json ファイルに以下の内容を追加してください:

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp"]
    }
  }
}

設定ファイルの場所:

スコープパス
プロジェクト<プロジェクト>/.gemini/settings.json
グローバル~/.gemini/settings.json

方法3: 環境変数を使用

特定の環境変数が必要な場合:

CLI:

gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp

設定ファイル:

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp"],
      "env": {
        "HTTP_PORT": "3002"
      }
    }
  }
}

接続テスト

  1. Roblox Studio を起動 → Pluginsタブ → WEPPYConnect
  2. Gemini CLIを起動して以下を入力:
    Roblox Studioで現在選択されているものを教えて

MCPサーバー状態の確認

Gemini CLI内で /mcp コマンドで接続しているサーバーの状態を確認できます:

/mcp

トラブルシューティング

サーバーが起動しないとき

MCPサーバーを直接実行してエラーを確認してください:

npx -y @weppy/roblox-mcp

接続失敗

  • Roblox Studioプラグインが Connected 状態か確認
  • ポート3002がファイアウォールにブロックされていないか確認
  • /mcp コマンドでサーバー状態を確認

ツールの競合

複数のMCPサーバーで同じ名前のツールがある場合、serverAlias__toolName 形式でプレフィックスが付きます。