Roblex Studio Model-Context-Protocol Server

Roblex Studio Model-Context-Protocol サーバー

Roblex Studio MCP Server は、Model-Context-Protocol 仕様に準拠したスタンドアロンのサーバー実装であり、Roblox Studio および LLM との連携に特化して設計されています。統一されたプロトコルを通じて、Roblox Studio での AI 主導のワークフローをシームレスかつ安全にスクリプト化できます。

特長

• npx でのワンラインインストール／実行：npx roblex-mcp ですぐに起動できます
• Roblox Studio の自動起動：MCP の起動時に Roblox Studio も自動で起動します（Windows）
• MCP の完全な実装：Model-Context-Protocol のすべてのコア機能に対応しています
• 複数のトランスポートモード：柔軟に連携できる SSE または STDIO
• Claude Desktop／Anthropic Claude に対応：すぐに利用できる連携機能
• セキュリティ：TPA 保護、入力のサニタイズ、レート制限、CORS など
• 拡張可能：カスタムツールやリソースを簡単に追加できます

クイックスタート

前提条件

• Node.js 18 以降（Node.js 20 以降を推奨）
• Roblox Studio のインストール（Windows。起動パスについては以下を参照）
• npm（Node.js に同梱）

npx で実行

npx roblex-mcp

• 初回起動時に MCP が起動し、Roblox Studio の自動起動を試みます。
• Roblox Studio が標準の場所にない場合は、.env ファイルまたはシステム環境変数に ROBLOX_STUDIO_PATH を設定してください。

環境変数の設定

環境変数のサンプルファイルをコピーして編集します。

cp .env.example .env

必要に応じて .env を編集します（ROBLOX_STUDIO_PATH については以下を参照してください）。

Roblox／Open Cloud API キーの設定

スクリプトの自動化とアセット管理を有効にするには、有効な Roblox Open Cloud API キーが必要です。

1. Roblox Open Cloud ダッシュボードに移動します。

2. API キーを作成をクリックし、必要な権限（例：「アセットの書き込み」、「ユニバースデータの読み取り」）を選択して、生成された API キーをコピーします。

3. キーを .env ファイルに設定します。

   ROBLOX_API_KEY=your_api_key_here
   ROBLOX_OPEN_CLOUD_API_KEY=your_open_cloud_api_key_here
   

   • シークレットキーは決して共有しないでください。パスワードと同様に扱ってください。
   • 必要に応じて、ユニバース単位の操作には ROBLOX_OPEN_CLOUD_UNIVERSE_ID を設定します。

4. .env の編集後、変更を適用するために MCP を再起動してください。

詳しくは、Roblox Open Cloud のドキュメントを参照してください。

環境変数

すべての設定は .env ファイルで管理できます。主な変数は次のとおりです。

• PORT：サーバーのポート（デフォルト：3001）

• TRANSPORT_MODE：「sse」または「stdio」（デフォルト：「stdio」）

• CLAUDE_DESKTOP_ENABLED：Claude Desktop との連携（デフォルト：true）

• ROBLOX_STUDIO_PATH：RobloxStudioBeta.exe のフルパス（任意）。例：

  ROBLOX_STUDIO_PATH=C:\Users\USER\AppData\Local\Roblox\Versions\version-04a222f011414c81\RobloxStudioBeta.exe
  

• ROBLOX_API_KEY、ROBLOX_OPEN_CLOUD_API_KEY：Roblox Open Cloud の API キー。ほとんどのサーバー機能で必須です。

すべてのオプションについては、.env.example を参照してください。

動作の仕組み

• npx roblex-mcp：

  • MCP サーバー（トランスポート、ツール、API、セキュリティなど）を起動します
  • Roblox Studio を自動で起動します
  • Claude Desktop、Open Cloud などと連携できます

• カスタムツールとリソース：

  • src/tools および src/resources ディレクトリを拡張して、独自のものを追加できます。

トラブルシューティング

• Roblox Studio が開かない場合

  • .env の ROBLOX_STUDIO_PATH に RobloxStudioBeta.exe のフルパスを設定してください。

• API キーのエラーまたは「Unauthorized」が表示される場合

  • API キーが有効で、適切な権限があり、.env に設定されていることを確認してください。

• 権限エラーまたはポートの競合が発生する場合

  • サーバーのポートをバインドする権限があることを確認するか、.env で標準以外のポートを選択してください。

• TypeScript／モジュールのエラーが発生する場合

  • ローカルで開発している場合は npm install と npm run build を実行してください。npx ユーザーは必要ありません。

• Claude Desktop が検出されない場合

  • .env で CLAUDE_DESKTOP_ENABLED=true に設定されていることと、Claude Desktop が実行中であることを確認してください。

開発

クローン、インストール、ビルドを行います。

git clone https://github.com/dmae97/roblex-studio-mcp-server.git
cd roblex-studio-mcp-server
npm install
npm run build
npm start

貢献

貢献を歓迎します！ガイドラインについては、CONTRIBUTING.mdをご覧ください。

ライセンス

MITライセンス - LICENSEをご覧ください。

---

© 2025 Roblex Studio MCP Server Contributors