Google Gemini CLIでRoblox MCPを使用する方法です。
前提条件
-
Node.js(v18.0.0以上)
node --version -
Gemini CLI インストール済み
npm install -g @google/gemini-cli -
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"
}
}
}
}
接続テスト
- Roblox Studio を起動 → Pluginsタブ → WEPPY → Connect
- Gemini CLIを起動して以下を入力:
Roblox Studioで現在選択されているものを教えて
MCPサーバー状態の確認
Gemini CLI内で /mcp コマンドで接続しているサーバーの状態を確認できます:
/mcp
トラブルシューティング
サーバーが起動しないとき
MCPサーバーを直接実行してエラーを確認してください:
npx -y @weppy/roblox-mcp
接続失敗
- Roblox Studioプラグインが Connected 状態か確認
- ポート3002がファイアウォールにブロックされていないか確認
/mcpコマンドでサーバー状態を確認
ツールの競合
複数のMCPサーバーで同じ名前のツールがある場合、serverAlias__toolName 形式でプレフィックスが付きます。