@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/ja/dashboard/sync.md

@@ -1,68 +0,0 @@
-# Sync
-
-> Studio ↔ ローカルファイル同期の現在の状態、方向設定、ログをモニタリングします。
-
-![Sync — 同期状態、方向設定、ログ](../../assets/screenshots/dashboard/dashboard_sync.png)
-
-> Sync機能自体の詳細ガイドは[Sync機能詳細ガイド](../sync/overview.md)をご参照ください。
-
-## 概要
-
-SyncページはStudio ↔ ローカルファイル同期の現在の状態と設定を視覚的に表示します。ダッシュボードが **Studio接続済み** 状態のときのみアクセスできます。
-
-## Sync Status
-
-現在の同期状態を表示します：
-
-| 状態 | 意味 |
-|------|------|
-| **Idle** | 同期待機中 |
-| **Initializing** | 初期同期進行中 |
-| **Syncing** | 増分同期進行中 |
-| **Error** | 同期エラー発生 |
-
-状態カードには同期パス、同期されたインスタンス数、現在の適用モード（Auto/Manual）が併せて表示されます。
-
-## Sync Directions
-
-タイプ別の同期方向をテーブルで表示します：
-
-| 列 | 説明 |
-|----|------|
-| Type | 同期対象タイプ（Scripts, Values, Instances, Data, Services） |
-| Direction | 同期方向（Local → Studio, Studio → Local） |
-| Apply Mode | 適用モード（Auto/Manual） |
-
-各タイプの同期方向を確認して、どの変更がどの方向に反映されるかを把握できます。
-
-## Sync Log
-
-同期イベントを時系列で表示します。各ログ項目には変更タイプタグ（create, update, deleteなど）と対象パスが含まれます。
-
-## 活用事例
-
-### 同期状態の確認
-
-```
-「Syncが正しく動作しているか確認したい」
-```
-
-Sync StatusがIdleであることを確認し、Sync Logで最近の変更が正常に記録されているか確認します。
-
-### 同期方向の把握
-
-```
-「スクリプトの変更がどの方向に同期されるか知りたい」
-```
-
-Sync DirectionsテーブルでScriptsタイプのDirectionを確認します。
-
-## 関連ドキュメント
-
-- [ダッシュボード Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [Sync機能詳細ガイド](../sync/overview.md)

package/docs/ja/dashboard/tools.md

@@ -1,69 +0,0 @@
-# Tools
-
-> AIが実行したMCPツールの履歴と統計を確認します。
-
-![Tools — ツール実行履歴と統計](../../assets/screenshots/dashboard/dashboard_tools.png)
-
-## 概要
-
-ToolsページはAIが実行したMCPツールの履歴と統計を提供します。**History**と**Statistics**の2つのサブタブで構成されています。ダッシュボードが **サーバー接続済み** または **Studio接続済み** 状態であれば常にアクセスできます。
-
-## Historyタブ
-
-ツール実行履歴を時系列テーブルで表示します：
-
-| 列 | 説明 |
-|----|------|
-| Time | 実行時間 |
-| Tool.Action | 実行されたツールとアクション（例：`query_instances.get_instance`） |
-| Duration | 実行所要時間 |
-| Status | 結果ステータス（OK/Error） |
-| Tier | 使用されたティア（Basic/Pro） |
-
-機能：
-- **Toolフィルター**ドロップダウンで特定のツールのみフィルタリング
-- ページネーションで大量の履歴を閲覧
-- リアルタイムで新しい実行履歴を追加
-
-## Statisticsタブ
-
-ツール使用統計を視覚的に分析します：
-
-- **ティア分布** — Basic/Proツール使用比率
-- **ツール別統計** — 各ツールの呼び出し回数、平均応答時間
-- **アクション別分析** — ツール内のアクション別詳細統計
-
-## Basicティア専用機能
-
-Basicティアユーザーには追加UIが表示されます：
-
-- **Tier Usage Progress** — 使用量プログレスバー
-- **Basic vs Pro比較モーダル** — Proティアの追加機能を案内
-
-## 活用事例
-
-### ツールパフォーマンス分析
-
-```
-「どのツールが最も時間がかかるか知りたい」
-```
-
-Statisticsタブでツール別の平均応答時間を確認します。
-
-### エラー追跡
-
-```
-「実行したツールが失敗した理由を知りたい」
-```
-
-HistoryタブでStatusがErrorの項目を見つけて詳細情報を確認します。
-
-## 関連ドキュメント
-
-- [ダッシュボード Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Settings](settings.md)
-- [Tool一覧](../tools/overview.md)

package/docs/ja/installation/README.md

@@ -1,93 +0,0 @@
-# インストールガイド
-
-Roblox MCPを使用するには、**2つ**をインストールする必要があります。
-
-```
-AIアプリ (Claude、Codex、Geminiなど)
-       │
-   MCPサーバー ← ここでAIの命令をRobloxが理解できる形式に変換
-       │
-Roblox Studioプラグイン ← Studio内で命令を実行
-```
-
-AIアプリが「青いパーツを作って」と言うと、MCPサーバーがこのリクエストを変換し、Roblox Studioプラグインが実際にパーツを作成します。
-
----
-
-## ワンラインインストール（推奨）
-
-1つのコマンドで導入できます:
-
-**macOS / Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
-```
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
-```
-
-Roblox Studioを再起動したら完了です！
-
-自動MCP登録は **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity** に対応しています。
-
-WindowsでPowerShellの実行がブロックされる場合は、下の手動インストールに進んでください。ZIPパッケージを使う場合は `setup-plugin.bat` と `setup-mcp.bat` を実行できます。
-
----
-
-## 手動インストール
-
-ワンラインインストールが動作しない場合、または環境上自動インストールを使えない場合に進める代替インストール方法です。
-
-### ステップ1: Roblox Studioプラグインのインストール
-
-GitHubからプラグインファイルをダウンロードして、Roblox StudioのPluginsフォルダに配置します。
-
-👉 [プラグインインストールガイド](https://weppyai.com/ja/install#plugin)
-
----
-
-### ステップ2: AIアプリにMCPサーバーを登録
-
-使用しているAIアプリにMCPサーバーを登録します。MCPをサポートするすべてのAIアプリで使用できます。
-
-| AIアプリ | 設定方法 |
-|---------|---------|
-| Claude Code | [設定手順](ai-apps/claude-code.md) |
-| Claude Desktop | [設定手順](ai-apps/claude-app.md) |
-| Cursor | [設定手順](ai-apps/cursor.md) |
-| Codex CLI | [設定手順](ai-apps/codex-cli.md) |
-| Codex Desktop | [設定手順](ai-apps/codex-app.md) |
-| Gemini CLI | [設定手順](ai-apps/gemini-cli.md) |
-| Antigravity | [設定手順](ai-apps/antigravity.md) |
-
-> 上記のリストにないAIアプリでも、MCPをサポートしていれば使用できます。MCPサーバーコマンド: `npx -y @weppy/roblox-mcp`
-
----
-
-## オプション: WEPPY Roblox Explorer (VSCode拡張) のインストール
-
-同期されたインスタンスツリーをRobloxクラスアイコン付きでVSCode内で閲覧できます。
-この拡張を使うには、先に上記のRoblox MCPセットアップを完了している必要があります。Explorer はプロジェクトルート配下の `weppy-project-sync` にある Sync データを読み取るためです。
-
-👉 [WEPPY Roblox Explorerインストールガイド](https://weppyai.com/ja/install#explorer)
-
-直接インストール:
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
----
-
-## インストール後
-
-1. **Roblox Studio**を開き、Pluginsタブから **WEPPY** → **Connect** をクリック
-2. **AIアプリ**で次のようにテストしてみてください:
-
-```
-Roblox Studioに青いパーツを作って
-```
-
-正常にパーツが作成されれば、インストール完了です!

package/docs/ja/installation/ai-apps/antigravity.md

@@ -1,89 +0,0 @@
-# Antigravity 設定
-
-[Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)でRoblox MCPを使用する方法です。
-
-> **Antigravity**はGoogleのエージェントベース開発プラットフォームで、AIエージェントがコード編集、ターミナル、ブラウザを横断して複雑なタスクを自律的に実行します。
-
-## 前提条件
-
-1. **Antigravity** がインストール済み（対応OS/要件は公式ドキュメント参照）
-2. **Node.js**（v18.0.0以上、`npx` が利用可能）
-3. **Roblox Studioプラグイン** のインストール完了
-
-## MCPサーバーの登録
-
-AntigravityではMCPサーバーを **エージェントパネル（Agent pane）** で管理します。
-
-### Raw configで手動登録（推奨）
-
-1. エージェントパネルで **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config** をクリック
-
-![MCP Serversメニューを開く](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
-
-2. 表示される設定（JSON）に以下の内容を追加/マージ:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-![Raw configを編集](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
-
-3. 保存後、**Refresh**（またはUIの案内に従って再起動/更新）を実行
-
-> 設定ファイルの実際のパス/名前はOSとAntigravityのバージョンによって異なる場合があります。必ず **View raw config** で案内される場所を基準に編集してください。
-
-### オプション: 環境変数でポート/ログを調整
-
-デフォルト値（HTTP `127.0.0.1:3002`）のまま利用することを推奨します。必要に応じて以下のように環境変数を設定できます:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_HOST": "127.0.0.1",
-        "HTTP_PORT": "3002",
-        "LOG_LEVEL": "INFO"
-      }
-    }
-  }
-}
-```
-
-## 接続テスト
-
-1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
-2. **Antigravity**で次を入力:
-   ```
-   Roblox Studioで現在選択されているものを教えて
-   ```
-
-## トラブルシューティング
-
-### サーバーが起動しない場合
-
-MCPサーバーを直接実行してエラーを確認してください:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 接続失敗
-
-- Roblox Studioプラグインが **Connected** 状態か確認
-- ポート **3002** がファイアウォールでブロックされていないか確認
-- エージェントパネル **⋯** → **MCP Servers** でサーバー状態を確認
-- (上級) `HTTP_PORT` を変更した場合は、Roblox Studioプラグイン/ブリッジ設定も同じポートを使用するように合わせる必要があります。
-
-## 参考資料
-
-- [Google Antigravity 紹介](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
-- [Antigravity 開始ガイド（Codelab）](https://codelabs.developers.google.com/getting-started-google-antigravity)

package/docs/ja/installation/ai-apps/claude-app.md

@@ -1,78 +0,0 @@
-# Claude Desktop App 設定
-
-[Claude Desktop App](https://claude.ai/download)でRoblox MCPを使用する方法です。
-
-## 前提条件
-
-- **Claude Desktop App** がインストール済み
-- **Node.js** (v18.0.0以上)
-- **Roblox Studioプラグイン** のインストール完了
-
-## MCPサーバーの登録
-
-### 方法1: Desktop Extensions (推奨)
-
-> 2026年からブラウザ拡張機能のようにワンクリックでインストール可能
-
-1. Claude Desktop → **Settings** → **Extensions**
-2. `weppy-roblox-mcp` を検索
-3. **Install** をクリック
-
-### 方法2: 設定ファイルを直接編集
-
-1. Claude Desktop → **Settings** → **Developers** → **Edit Config** をクリック
-
-2. `claude_desktop_config.json` ファイルに以下の内容を追加:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. Claude Desktopを**完全に終了**してから再起動
-
-**設定ファイルの場所:**
-
-| OS | パス |
-|----|------|
-| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
-
-## 接続テスト
-
-1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
-2. **Claude Desktop**で新しい会話を開始してテスト:
-   ```
-   Roblox Studioに青いパーツを作って
-   ```
-
-## トラブルシューティング
-
-### MCPサーバーがロードされない
-
-1. **JSON構文の確認**: オンラインのJSON validatorで設定ファイルを検証
-2. **Claude Desktopの完全再起動**: 設定変更後は必ずアプリを完全終了してから再起動
-3. **パスの確認**: commandとargsが正しいか確認
-
-### サーバーが起動しない場合
-
-MCPサーバーを直接実行してエラーを確認してください:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 接続失敗
-
-- Roblox Studioプラグインが **Connected** 状態か確認
-- ポート3002がファイアウォールでブロックされていないか確認
-
-## 参考資料
-
-- [Claude Desktop MCP公式ガイド](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)
-- [MCPサーバー接続ガイド](https://modelcontextprotocol.io/docs/develop/connect-local-servers)

package/docs/ja/installation/ai-apps/claude-code.md

@@ -1,104 +0,0 @@
-# Claude Code 設定
-
-[Claude Code](https://claude.ai/code) (ターミナルベースのAIコーディングツール)でRoblox MCPを使用する方法です。
-
-## 前提条件
-
-- **Claude Code** がインストール済み
-- **Roblox Studioプラグイン** のインストール完了
-
-## インストール
-
-```bash
-npm install -g @anthropic-ai/claude-code
-```
-
-## MCPサーバーの登録
-
-### 方法1: マーケットプレイスからインストール (推奨)
-
-Claude Codeターミナルで実行:
-
-```bash
-# マーケットプレイスを追加
-/plugin marketplace add hope1026/weppy-roblox-mcp
-
-# プラグインをインストール
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-インストール確認:
-```bash
-/plugin list
-```
-
-### 方法2: 設定ファイルを直接編集
-
-`.mcp.json` ファイルを作成:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**設定ファイルの場所:**
-
-| 範囲 | パス |
-|------|------|
-| プロジェクト | `<プロジェクト>/.mcp.json` |
-| グローバル | `~/.claude/mcp.json` |
-
-## 自動サーバー管理
-
-Claude CodeはMCPサーバーを自動的に管理します:
-
-- 必要時に自動起動
-- セッション終了時に自動停止
-- 追加設定は不要
-
-## 接続テスト
-
-1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
-2. **Claude Code**でテスト:
-   ```
-   Roblox Studioに青いパーツを作って
-   ```
-
-## トラブルシューティング
-
-### プラグインのインストール失敗
-
-```bash
-# キャッシュをクリアして再試行
-/plugin cache clear
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-### サーバーが起動しない
-
-1. Node.jsのバージョンを確認 (18.0以上が必要):
-   ```bash
-   node --version
-   ```
-
-2. 手動でサーバー起動をテスト:
-   ```bash
-   npx -y @weppy/roblox-mcp
-   ```
-
-### MCPツールが表示されない
-
-Claude Codeで確認:
-```
-利用可能なMCPツールの一覧を表示して
-```
-
-## 参考資料
-
-- [Claude Code公式ドキュメント](https://docs.anthropic.com/claude-code)

package/docs/ja/installation/ai-apps/codex-app.md

@@ -1,56 +0,0 @@
-# Codex App 設定
-
-[OpenAI Codex App](https://openai.com/codex/) (macOS)でRoblox MCPを使用する方法です。
-
-> **2026年2月2日リリース** - マルチエージェントワークフローをサポートするネイティブmacOSアプリ
-
-## 前提条件
-
-- **Codex App** がインストール済み (macOS)
-- **Roblox Studioプラグイン** のインストール完了
-
-## MCPサーバーの登録
-
-### Codex CLI設定の自動同期
-
-Codex CLIで既にMCPを設定している場合、**追加設定なしで**アプリですぐに使用できます。
-
-```
-CLIのセッション履歴と設定は自動的にアプリに同期されます。
-```
-
-### 新規設定の場合
-
-アプリ内の **Settings** → **MCP Servers** で追加:
-
-```
-Server name: weppy-roblox-mcp
-Command: npx -y @weppy/roblox-mcp
-```
-
-## 接続テスト
-
-1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
-2. **Codex App**で新しい会話を開始してテスト:
-   ```
-   Roblox Studioで現在選択されているものを教えて
-   ```
-
-## トラブルシューティング
-
-### サーバーが起動しない場合
-
-MCPサーバーを直接実行してエラーを確認してください:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 接続失敗
-
-- Roblox Studioプラグインが **Connected** 状態か確認
-- ポート3002がファイアウォールでブロックされていないか確認
-
-## 参考資料
-
-- [Codex App紹介](https://openai.com/index/introducing-the-codex-app/)
-- [Codex MCP公式ドキュメント](https://developers.openai.com/codex/mcp/)

package/docs/ja/installation/ai-apps/codex-cli.md

@@ -1,67 +0,0 @@
-# Codex CLI 設定
-
-[OpenAI Codex CLI](https://github.com/openai/codex) (ターミナルベースのAIコーディングツール)でRoblox MCPを使用する方法です。
-
-## 前提条件
-
-- **Node.js** (v18.0.0以上)
-- **Roblox Studioプラグイン** のインストール完了
-
-## インストール
-
-```bash
-npm install -g @openai/codex
-```
-
-## MCPサーバーの登録
-
-### 方法1: CLIコマンド (推奨)
-
-```bash
-codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
-```
-
-### 方法2: 設定ファイルを直接編集
-
-`~/.codex/config.toml` ファイルに以下の内容を追加してください:
-
-```toml
-[mcp_servers.weppy-roblox-mcp]
-command = "npx"
-args = ["-y", "@weppy/roblox-mcp"]
-```
-
-**設定ファイルの場所:**
-
-| OS | パス |
-|----|------|
-| macOS/Linux | `~/.codex/config.toml` |
-| Windows | `%USERPROFILE%\.codex\config.toml` |
-
-## 接続テスト
-
-1. **Roblox Studio** を起動 → Pluginsタブ → **WEPPY** → **Connect**
-2. **Codex CLI** を起動して以下を入力:
-   ```
-   Roblox Studioで現在選択されているものを教えて
-   ```
-
-## トラブルシューティング
-
-### サーバーが起動しない場合
-
-MCPサーバーを直接実行してエラーを確認してください:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 接続失敗
-
-- Roblox Studioプラグインが **Connected** 状態か確認
-- ポート3002がファイアウォールでブロックされていないか確認
-
-## 参考資料
-
-- [Codex CLI GitHub](https://github.com/openai/codex)
-- [Codex MCP公式ドキュメント](https://developers.openai.com/codex/mcp/)
-- [Codex設定リファレンス](https://developers.openai.com/codex/config-reference/)