@weppy/roblox-mcp 0.1.9 → 0.1.11

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/ai-apps/gemini-cli.md

@@ -18,7 +18,23 @@
 
 ## MCP 서버 등록
 
-### 방법 1: 설정 파일 편집 (권장)
+### 방법 1: CLI 명령어 (권장)
+
+터미널에서 한 줄로 등록할 수 있습니다:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> `--trust` 플래그는 도구 호출 시 매번 확인 프롬프트를 건너뜁니다.
+
+글로벌 설정으로 등록하려면 `-s user`를 추가하세요:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### 방법 2: 설정 파일 편집
 
 `.gemini/settings.json` 파일에 아래 내용을 추가하세요:
 
@@ -39,10 +55,16 @@
 | 프로젝트 | `<프로젝트>/.gemini/settings.json` |
 | 글로벌 | `~/.gemini/settings.json` |
 
-### 방법 2: 환경 변수 사용
+### 방법 3: 환경 변수 사용
 
 특정 환경 변수가 필요한 경우:
 
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
+
+**설정 파일:**
 ```json
 {
   "mcpServers": {
@@ -73,35 +95,6 @@ Gemini CLI 내에서 `/mcp` 명령으로 연결된 서버 상태를 확인할
 /mcp
 ```
 
-## 고급 설정
-
-### 도구 필터링
-
-특정 도구만 사용하거나 제외할 수 있습니다:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools`가 `includeTools`보다 우선합니다.
-
-### 디버그 모드
-
-연결 문제를 디버깅하려면:
-
-```bash
-gemini --debug
-```
-
 ## 문제 해결
 
 ### 서버가 시작되지 않을 때

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/ai-apps/gemini-cli.md

@@ -1,8 +1,8 @@
-# Configuracao do Gemini CLI
+# Configuração do Gemini CLI
 
-Como usar o Roblox MCP no [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
+Como usar o Roblox MCP com [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
 
-## Pre-requisitos
+## Pré-requisitos
 
 1. **Node.js** (v18.0.0 ou superior)
    ```bash
@@ -16,11 +16,27 @@ Como usar o Roblox MCP no [Google Gemini CLI](https://github.com/google-gemini/g
 
 3. **Plugin do Roblox Studio** instalado
 
-## Registrar o Servidor MCP
+## Registrar servidor MCP
 
-### Metodo 1: Editar Arquivo de Configuracao (Recomendado)
+### Método 1: Comando CLI (Recomendado)
 
-Adicione o seguinte conteudo ao arquivo `.gemini/settings.json`:
+Registre com um único comando no terminal:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> A flag `--trust` ignora as solicitações de confirmação para cada chamada de ferramenta.
+
+Para registrar globalmente, adicione `-s user`:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### Método 2: Editar arquivo de configuração
+
+Adicione o seguinte conteúdo ao arquivo `.gemini/settings.json`:
 
 ```json
 {
@@ -33,16 +49,22 @@ Adicione o seguinte conteudo ao arquivo `.gemini/settings.json`:
 }
 ```
 
-**Localizacao do arquivo de configuracao:**
+**Localizações do arquivo de configuração:**
 | Escopo | Caminho |
 |--------|---------|
 | Projeto | `<projeto>/.gemini/settings.json` |
 | Global | `~/.gemini/settings.json` |
 
-### Metodo 2: Usar Variaveis de Ambiente
+### Método 3: Usando variáveis de ambiente
+
+Se variáveis de ambiente específicas forem necessárias:
 
-Se variaveis de ambiente especificas forem necessarias:
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
 
+**Arquivo de configuração:**
 ```json
 {
   "mcpServers": {
@@ -57,71 +79,42 @@ Se variaveis de ambiente especificas forem necessarias:
 }
 ```
 
-## Teste de Conexao
+## Teste de conexão
 
-1. Inicie o **Roblox Studio** → Aba Plugins → **W-MCP** → **Connect**
-2. Inicie o **Gemini CLI** e digite:
+1. Abra o **Roblox Studio** → aba Plugins → **W-MCP** → **Connect**
+2. Execute o **Gemini CLI** e digite:
    ```
-   Diga-me o que esta selecionado atualmente no Roblox Studio
+   Me diga o que está selecionado atualmente no Roblox Studio
    ```
 
-## Verificar Status do Servidor MCP
+## Verificar status do servidor MCP
 
-Voce pode verificar o status do servidor conectado com o comando `/mcp` no Gemini CLI:
+Você pode verificar o status dos servidores conectados com o comando `/mcp` no Gemini CLI:
 
 ```
 /mcp
 ```
 
-## Configuracao Avancada
-
-### Filtragem de Ferramentas
-
-Voce pode usar ou excluir ferramentas especificas:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` tem prioridade sobre `includeTools`.
-
-### Modo de Depuracao
-
-Para depurar problemas de conexao:
-
-```bash
-gemini --debug
-```
-
-## Solucao de Problemas
+## Solução de problemas
 
-### O servidor nao inicia
+### Servidor não inicia
 
 Execute o servidor MCP diretamente para verificar erros:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
-### Falha na conexao
+### Falha na conexão
 
-- Verifique se o plugin do Roblox Studio esta no estado **Connected**
-- Verifique se a porta 3002 nao esta bloqueada pelo firewall
+- Verifique se o plugin do Roblox Studio está no estado **Connected**
+- Verifique se a porta 3002 está bloqueada por um firewall
 - Verifique o status do servidor com o comando `/mcp`
 
-### Conflito de ferramentas
+### Conflitos de ferramentas
 
-Se varios servidores MCP tiverem ferramentas com o mesmo nome, elas serao prefixadas no formato `serverAlias__toolName`.
+Se vários servidores MCP tiverem ferramentas com o mesmo nome, elas receberão o prefixo no formato `serverAlias__toolName`.
 
-## Referencias
+## Referências
 
-- [Documentacao Oficial de MCP do Gemini CLI](https://geminicli.com/docs/tools/mcp-server/)
-- [Guia de Configuracao do Gemini CLI](https://geminicli.com/docs/get-started/configuration/)
+- [Documentação oficial do Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
+- [Guia de configuração do Gemini CLI](https://geminicli.com/docs/get-started/configuration/)

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.11",
   "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.11",
   "author": {
     "name": "hope1026"
   },