@weppy/roblox-mcp 0.1.9 → 0.1.10

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

@@ -6,23 +6,21 @@
 
 ## 前提条件
 
-1. **Antigravity** がインストール済み (macOS, Windows, Linux対応)
-2. **Roblox Studioプラグイン** のインストール完了
+1. **Antigravity** がインストール済み（対応OS/要件は公式ドキュメント参照）
+2. **Node.js**（v18.0.0以上、`npx` が利用可能）
+3. **Roblox Studioプラグイン** のインストール完了
 
 ## MCPサーバーの登録
 
-### 方法1: MCP Storeからインストール (推奨)
+AntigravityではMCPサーバーを **エージェントパネル（Agent pane）** で管理します。
 
-1. Antigravityを起動
-2. **Settings** → **MCP** に移動
-3. MCP Storeで `weppy-roblox-mcp` を検索
-4. **Install** をクリック
+### Raw configで手動登録（推奨）
 
-### 方法2: 設定ファイルを直接編集
+1. エージェントパネルで **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config** をクリック
 
-1. Antigravityで **⋯** メニュー → **MCP Servers** → **Manage MCP Servers** → **View raw config** をクリック
+![MCP Serversメニューを開く](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
 
-2. `mcp_config.json` ファイルに以下の内容を追加:
+2. 表示される設定（JSON）に以下の内容を追加/マージ:
 
 ```json
 {
@@ -35,26 +33,15 @@
 }
 ```
 
-3. 保存後、**Manage MCP Servers** で **Refresh** をクリック
+![Raw configを編集](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
 
-**設定ファイルの場所:**
+3. 保存後、**Refresh**（またはUIの案内に従って再起動/更新）を実行
 
-| OS | パス |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
+> 設定ファイルの実際のパス/名前はOSとAntigravityのバージョンによって異なる場合があります。必ず **View raw config** で案内される場所を基準に編集してください。
 
-### 方法3: Agentに依頼
+### オプション: 環境変数でポート/ログを調整
 
-Antigravity Agentに直接依頼することもできます:
-
-```
-Roblox MCP (@weppy/roblox-mcp)をMCPサーバーとして追加して
-```
-
-## 重要: 絶対パスの使用
-
-> **注意**: Antigravityは `${workspaceFolder}` 変数をサポートしていません。必ず**絶対パス**を使用してください。
+デフォルト値（HTTP `127.0.0.1:3002`）のまま利用することを推奨します。必要に応じて以下のように環境変数を設定できます:
 
 ```json
 {
@@ -63,7 +50,9 @@ Roblox MCP (@weppy/roblox-mcp)をMCPサーバーとして追加して
       "command": "npx",
       "args": ["-y", "@weppy/roblox-mcp"],
       "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
+        "HTTP_HOST": "127.0.0.1",
+        "HTTP_PORT": "3002",
+        "LOG_LEVEL": "INFO"
       }
     }
   }
@@ -73,29 +62,11 @@ Roblox MCP (@weppy/roblox-mcp)をMCPサーバーとして追加して
 ## 接続テスト
 
 1. **Roblox Studio** を起動 → Pluginsタブ → **W-MCP** → **Connect**
-2. **Antigravity**で以下を入力:
+2. **Antigravity**で次を入力:
    ```
    Roblox Studioで現在選択されているものを教えて
    ```
 
-## Skillsの活用
-
-Antigravityの**Skills**システムと組み合わせることで、より強力なワークフローを構築できます:
-
-- プロジェクト別のRoblox開発ワークフローを定義
-- よく使うタスクをSkillとしてパッケージ化
-- エージェントが自動的にタスクを計画、実行、検証
-
-## サポートモデル
-
-AntigravityでRoblox MCPを使用する際、以下のモデルを選択できます:
-
-| モデル | 特徴 |
-|------|------|
-| **Gemini 3 Pro** | デフォルトモデル、無料で使用可能 |
-| **Claude Sonnet 4.5** | Anthropicモデル対応 |
-| **GPT-OSS** | OpenAIモデル対応 |
-
 ## トラブルシューティング
 
 ### サーバーが起動しない場合
@@ -108,23 +79,11 @@ npx -y @weppy/roblox-mcp
 ### 接続失敗
 
 - Roblox Studioプラグインが **Connected** 状態か確認
-- ポート3002がファイアウォールでブロックされていないか確認
-- Settings → MCPでサーバー状態を確認
-
-### 絶対パスエラー
-
-`${workspaceFolder}` を使用するとエラーが発生します。絶対パスに変更してください:
-
-```json
-// ❌ 間違い
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ 正しい
-"args": ["--workspace", "/absolute/path/to/project"]
-```
+- ポート **3002** がファイアウォールでブロックされていないか確認
+- エージェントパネル **⋯** → **MCP Servers** でサーバー状態を確認
+- (上級) `HTTP_PORT` を変更した場合は、Roblox Studioプラグイン/ブリッジ設定も同じポートを使用するように合わせる必要があります。
 
 ## 参考資料
 
-- [Antigravity入門ガイド](https://codelabs.developers.google.com/getting-started-google-antigravity)
-- [Antigravity MCP連携ガイド](https://composio.dev/blog/howto-mcp-antigravity)
-- [Antigravity Skillsコレクション](https://github.com/sickn33/antigravity-awesome-skills)
+- [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/roblox-plugin.md

@@ -4,7 +4,7 @@ Roblox StudioでAIエージェントと連携するためのプラグインイ
 
 ## 1. プラグインのダウンロード
 
-1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)から `weppy-roblox-mcp-basic.zip` をダウンロードします
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)から `weppy-roblox-mcp-basic-v{バージョン}.zip` をダウンロードします
 2. ZIPファイルを解凍します — `roblox-plugin/WeppyRobloxMCP.rbxm` ファイルとセットアップガイドが含まれています
 
 ## 2. プラグインのインストール

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

@@ -6,23 +6,21 @@
 
 ## 사전 요구사항
 
-1. **Antigravity** 설치됨 (macOS, Windows, Linux 지원)
-2. **Roblox Studio 플러그인** 설치 완료
+1. **Antigravity** 설치됨 (지원 OS/요구사항은 공식 문서 참고)
+2. **Node.js** (v18.0.0 이상, `npx` 사용 가능)
+3. **Roblox Studio 플러그인** 설치 완료
 
 ## MCP 서버 등록
 
-### 방법 1: MCP Store에서 설치 (권장)
+Antigravity에서는 MCP 서버를 **에이전트 패널(Agent pane)**에서 관리합니다.
 
-1. Antigravity 실행
-2. **Settings** → **MCP** 이동
-3. MCP Store에서 `weppy-roblox-mcp` 검색
-4. **Install** 클릭
+### Raw config로 수동 등록 (권장)
 
-### 방법 2: 설정 파일 직접 편집
+1. 에이전트 패널에서 **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config** 클릭
 
-1. Antigravity에서 **⋯** 메뉴 → **MCP Servers** → **Manage MCP Servers** → **View raw config** 클릭
+![MCP Servers 메뉴 열기](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
 
-2. `mcp_config.json` 파일에 아래 내용을 추가:
+2. 표시되는 설정(JSON)에 아래 내용을 추가/병합:
 
 ```json
 {
@@ -34,27 +32,15 @@
   }
 }
 ```
+![Raw config 수정](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
 
-3. 저장 후 **Manage MCP Servers**에서 **Refresh** 클릭
+3. 저장 후 **Refresh**(또는 UI 안내에 따른 재시작/새로고침) 수행
 
-**설정 파일 위치:**
+> 설정 파일의 실제 경로/이름은 OS와 Antigravity 버전에 따라 달라질 수 있으므로, 항상 **View raw config**에서 안내되는 위치를 기준으로 수정하세요.
 
-| OS | 경로 |
-|----|------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
+### 옵션: 환경 변수로 포트/로그 조정
 
-### 방법 3: Agent에게 요청
-
-Antigravity Agent에게 직접 요청할 수도 있습니다:
-
-```
-Roblox MCP (@weppy/roblox-mcp)를 MCP 서버로 추가해줘
-```
-
-## 중요: 절대 경로 사용
-
-> **주의**: Antigravity는 `${workspaceFolder}` 변수를 지원하지 않습니다. 반드시 **절대 경로**를 사용하세요.
+기본값(HTTP `127.0.0.1:3002`)을 유지하는 것을 권장합니다. 필요 시 아래처럼 환경 변수를 설정할 수 있습니다:
 
 ```json
 {
@@ -63,7 +49,9 @@ Roblox MCP (@weppy/roblox-mcp)를 MCP 서버로 추가해줘
       "command": "npx",
       "args": ["-y", "@weppy/roblox-mcp"],
       "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
+        "HTTP_HOST": "127.0.0.1",
+        "HTTP_PORT": "3002",
+        "LOG_LEVEL": "INFO"
       }
     }
   }
@@ -78,24 +66,6 @@ Roblox MCP (@weppy/roblox-mcp)를 MCP 서버로 추가해줘
    Roblox Studio에서 현재 선택된 것을 알려줘
    ```
 
-## Skills 활용
-
-Antigravity의 **Skills** 시스템과 함께 사용하면 더 강력한 워크플로우를 구성할 수 있습니다:
-
-- 프로젝트별 Roblox 개발 워크플로우 정의
-- 자주 사용하는 작업을 Skill로 패키징
-- 에이전트가 자동으로 작업을 계획, 실행, 검증
-
-## 지원 모델
-
-Antigravity에서 Roblox MCP를 사용할 때 다음 모델을 선택할 수 있습니다:
-
-| 모델 | 특징 |
-|------|------|
-| **Gemini 3 Pro** | 기본 모델, 무료 사용 가능 |
-| **Claude Sonnet 4.5** | Anthropic 모델 지원 |
-| **GPT-OSS** | OpenAI 모델 지원 |
-
 ## 문제 해결
 
 ### 서버가 시작되지 않을 때
@@ -108,23 +78,11 @@ npx -y @weppy/roblox-mcp
 ### 연결 실패
 
 - Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
-- Settings → MCP에서 서버 상태 확인
-
-### 절대 경로 오류
-
-`${workspaceFolder}` 사용 시 오류가 발생합니다. 절대 경로로 변경하세요:
-
-```json
-// ❌ 잘못됨
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ 올바름
-"args": ["--workspace", "/absolute/path/to/project"]
-```
+- 포트 **3002**가 방화벽에 의해 차단되지 않았는지 확인
+- 에이전트 패널 **⋯** → **MCP Servers**에서 서버 상태 확인
+- (고급) `HTTP_PORT`를 변경했다면, Roblox Studio 플러그인/브릿지 설정도 동일 포트를 사용하도록 맞춰야 합니다.
 
 ## 참고 자료
 
-- [Antigravity 시작 가이드](https://codelabs.developers.google.com/getting-started-google-antigravity)
-- [Antigravity MCP 연동 가이드](https://composio.dev/blog/howto-mcp-antigravity)
-- [Antigravity Skills 컬렉션](https://github.com/sickn33/antigravity-awesome-skills)
+- [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/ko/installation/roblox-plugin.md

@@ -4,7 +4,7 @@ Roblox Studio에서 AI 에이전트와 연결하기 위한 플러그인 설치
 
 ## 1. 플러그인 다운로드
 
-1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)에서 `weppy-roblox-mcp-basic.zip`을 다운로드합니다
+1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)에서 `weppy-roblox-mcp-basic-v{버전}.zip`을 다운로드합니다
 2. ZIP 파일을 압축 해제합니다 — `roblox-plugin/WeppyRobloxMCP.rbxm` 파일과 설치 가이드가 포함되어 있습니다
 
 ## 2. 플러그인 설치

package/docs/pt-br/installation/ai-apps/antigravity.md

@@ -1,28 +1,26 @@
-# Configuracao do Antigravity
+# Configuração do Antigravity
 
-Como usar o Roblox MCP no [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
+Como usar o Roblox MCP com o [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
 
-> **Antigravity** e a plataforma de desenvolvimento baseada em agentes do Google, onde agentes de IA realizam tarefas complexas de forma autonoma atraves de edicao de codigo, terminal e navegador.
+> **Antigravity** é a plataforma de desenvolvimento baseada em agentes do Google, em que agentes de IA realizam tarefas complexas de forma autônoma alternando entre edição de código, terminal e navegador.
 
-## Pre-requisitos
+## Pré-requisitos
 
-1. **Antigravity** instalado (suporta macOS, Windows, Linux)
-2. **Plugin do Roblox Studio** instalado
+1. **Antigravity** instalado (consulte a documentação oficial para SO suportados/requisitos)
+2. **Node.js** (v18.0.0 ou superior, `npx` disponível)
+3. **Plugin do Roblox Studio** instalado
 
-## Registrar o Servidor MCP
+## Registrar servidor MCP
 
-### Metodo 1: Instalar pela MCP Store (Recomendado)
+No Antigravity, os servidores MCP são gerenciados no **painel do agente (Agent pane)**.
 
-1. Inicie o Antigravity
-2. Va para **Settings** → **MCP**
-3. Pesquise por `weppy-roblox-mcp` na MCP Store
-4. Clique em **Install**
+### Registro manual via raw config (recomendado)
 
-### Metodo 2: Editar Arquivo de Configuracao Diretamente
+1. No painel do agente, clique em **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
 
-1. No Antigravity, clique no menu **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
+![Abrir menu MCP Servers](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
 
-2. Adicione o seguinte conteudo ao arquivo `mcp_config.json`:
+2. No JSON exibido, adicione/mescle o conteúdo abaixo:
 
 ```json
 {
@@ -35,26 +33,15 @@ Como usar o Roblox MCP no [Google Antigravity](https://developers.googleblog.com
 }
 ```
 
-3. Apos salvar, clique em **Refresh** em **Manage MCP Servers**
+![Editar raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
 
-**Localizacao do arquivo de configuracao:**
+3. Após salvar, faça **Refresh** (ou reinicie/atualize conforme a UI orientar)
 
-| SO | Caminho |
-|----|---------|
-| macOS/Linux | `~/.gemini/antigravity/mcp_config.json` |
-| Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` |
+> O caminho/nome real do arquivo de configuração pode variar conforme o SO e a versão do Antigravity. Sempre edite com base no local indicado em **View raw config**.
 
-### Metodo 3: Solicitar ao Agente
+### Opção: Ajustar porta/logs via variáveis de ambiente
 
-Voce tambem pode solicitar diretamente ao Agente do Antigravity:
-
-```
-Adicione o Roblox MCP (@weppy/roblox-mcp) como servidor MCP
-```
-
-## Importante: Use Caminhos Absolutos
-
-> **Atencao**: O Antigravity nao suporta a variavel `${workspaceFolder}`. Voce deve usar **caminhos absolutos**.
+Recomendamos manter o padrão (HTTP `127.0.0.1:3002`). Se necessário, você pode definir variáveis de ambiente assim:
 
 ```json
 {
@@ -63,68 +50,40 @@ Adicione o Roblox MCP (@weppy/roblox-mcp) como servidor MCP
       "command": "npx",
       "args": ["-y", "@weppy/roblox-mcp"],
       "env": {
-        "PROJECT_ROOT": "/Users/username/projects/my-roblox-game"
+        "HTTP_HOST": "127.0.0.1",
+        "HTTP_PORT": "3002",
+        "LOG_LEVEL": "INFO"
       }
     }
   }
 }
 ```
 
-## Teste de Conexao
+## Teste de conexão
 
-1. Inicie o **Roblox Studio** → Aba Plugins → **W-MCP** → **Connect**
-2. Digite no **Antigravity**:
+1. Abra o **Roblox Studio** → aba Plugins → **W-MCP** → **Connect**
+2. No **Antigravity**, digite:
    ```
-   Diga-me o que esta selecionado atualmente no Roblox Studio
+   Diga-me o que está selecionado atualmente no Roblox Studio
    ```
 
-## Utilizando Skills
-
-Ao usar com o sistema de **Skills** do Antigravity, voce pode criar fluxos de trabalho mais poderosos:
-
-- Defina fluxos de trabalho de desenvolvimento Roblox por projeto
-- Empacote tarefas frequentes como Skills
-- O agente planeja, executa e verifica tarefas automaticamente
-
-## Modelos Suportados
-
-Ao usar o Roblox MCP no Antigravity, voce pode escolher os seguintes modelos:
+## Solução de problemas
 
-| Modelo | Caracteristicas |
-|--------|-----------------|
-| **Gemini 3 Pro** | Modelo padrao, uso gratuito disponivel |
-| **Claude Sonnet 4.5** | Suporte a modelo Anthropic |
-| **GPT-OSS** | Suporte a modelo OpenAI |
+### Se o servidor não iniciar
 
-## Solucao de Problemas
-
-### O servidor nao inicia
-
-Execute o servidor MCP diretamente para verificar erros:
+Execute o servidor MCP diretamente para verificar o erro:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
-### Falha na conexao
-
-- Verifique se o plugin do Roblox Studio esta no estado **Connected**
-- Verifique se a porta 3002 nao esta bloqueada pelo firewall
-- Verifique o status do servidor em Settings → MCP
-
-### Erro de caminho absoluto
+### Falha na conexão
 
-Erros ocorrem ao usar `${workspaceFolder}`. Altere para caminho absoluto:
-
-```json
-// ❌ Incorreto
-"args": ["--workspace", "${workspaceFolder}"]
-
-// ✅ Correto
-"args": ["--workspace", "/absolute/path/to/project"]
-```
+- Verifique se o plugin do Roblox Studio está em **Connected**
+- Verifique se a porta **3002** não está bloqueada pelo firewall
+- Verifique o status do servidor no painel do agente **⋯** → **MCP Servers**
+- (Avançado) Se você alterou `HTTP_PORT`, o plugin/bridge do Roblox Studio também precisa usar a mesma porta.
 
-## Referencias
+## Materiais de referência
 
-- [Guia de Introducao ao Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
-- [Guia de Integracao MCP do Antigravity](https://composio.dev/blog/howto-mcp-antigravity)
-- [Colecao de Skills do Antigravity](https://github.com/sickn33/antigravity-awesome-skills)
+- [Introdução ao Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
+- [Guia de primeiros passos do Antigravity (Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)

package/docs/pt-br/installation/roblox-plugin.md

@@ -4,7 +4,7 @@ Como instalar o plugin para conectar com agentes de IA no Roblox Studio.
 
 ## 1. Baixar o Plugin
 
-1. Baixe `weppy-roblox-mcp-basic.zip` em [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+1. Baixe `weppy-roblox-mcp-basic-v{versão}.zip` em [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
 2. Extraia o arquivo ZIP — voce encontrara o arquivo `roblox-plugin/WeppyRobloxMCP.rbxm` e guias de instalacao
 
 ## 2. Instalar o Plugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - 130+ tools for AI-powered game development with specialized agents and skills",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "author": {
     "name": "hope1026"
   },