@weppy/roblox-mcp 2.5.1 → 2.6.0

package/docs/ko/installation/README.md

@@ -1,95 +0,0 @@
-# 설치 가이드
-
-Roblox MCP를 사용하려면 **두 가지**를 설치해야 합니다.
-
-```
-AI 앱 (Claude, Codex, Gemini 등)
-       │
-   MCP 서버 ← 여기서 AI의 명령을 Roblox가 이해하는 형태로 변환
-       │
-Roblox Studio 플러그인 ← Studio 안에서 명령을 실행
-```
-
-AI 앱이 "파란 파트를 만들어줘"라고 하면, MCP 서버가 이 요청을 변환하고, Roblox Studio 플러그인이 실제로 파트를 만듭니다.
-
----
-
-## 원라인 설치 (권장)
-
-아래 명령어 한 줄로 MCP 서버와 플러그인을 한 번에 설치합니다:
-
-**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
-```
-
-AI 앱을 다시 열고 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/ko/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/ko/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/ko/installation/ai-apps/antigravity.md

@@ -1,88 +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/ko/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/ko/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/ko/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/ko/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/)

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

@@ -1,77 +0,0 @@
-# Cursor 설정
-
-[Cursor](https://cursor.com/)에서 Roblox MCP를 사용하는 방법입니다.
-
-## 사전 요구사항
-
-- **Cursor** 설치됨
-- **Node.js** (v18.0.0 이상)
-- **Roblox Studio 플러그인** 설치 완료
-
-## MCP 서버 등록
-
-### 방법 1: 프로젝트 설정
-
-프로젝트의 `.cursor/mcp.json` 파일에 아래 내용을 추가하세요:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-### 방법 2: 글로벌 설정
-
-전역 Cursor MCP 설정 파일에 같은 내용을 추가하세요.
-
-**설정 파일 위치:**
-
-| 범위 | 경로 |
-|------|------|
-| 프로젝트 | `<프로젝트>/.cursor/mcp.json` |
-| 글로벌 (macOS/Linux) | `~/.cursor/mcp.json` |
-| 글로벌 (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
-
-> 파일이 이미 있으면 기존 `mcpServers` 객체 안에 `weppy-roblox-mcp` 항목만 병합하세요.
-
-### 적용
-
-설정을 수정한 뒤 Cursor 창을 다시 로드하거나 앱을 재시작하세요.
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
-2. **Cursor**에서 다음을 입력:
-   ```
-   Roblox Studio에서 현재 선택된 것을 알려줘
-   ```
-
-## 문제 해결
-
-### MCP 서버가 보이지 않을 때
-
-- 설정 파일 경로가 올바른지 확인
-- JSON 문법이 유효한지 확인
-- 설정 변경 후 Cursor를 다시 로드했는지 확인
-
-### 서버가 시작되지 않을 때
-
-MCP 서버를 직접 실행하여 오류를 확인하세요:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 연결 실패
-
-- Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
-
-## 참고 자료
-
-- [Cursor MCP 문서](https://docs.cursor.com/context/model-context-protocol)

package/docs/ko/installation/ai-apps/gemini-cli.md

@@ -1,120 +0,0 @@
-# Gemini CLI 설정
-
-[Google Gemini CLI](https://github.com/google-gemini/gemini-cli)에서 Roblox MCP를 사용하는 방법입니다.
-
-## 사전 요구사항
-
-1. **Node.js** (v18.0.0 이상)
-   ```bash
-   node --version
-   ```
-
-2. **Gemini CLI** 설치됨
-   ```bash
-   npm install -g @google/gemini-cli
-   ```
-
-3. **Roblox Studio 플러그인** 설치 완료
-
-## MCP 서버 등록
-
-### 방법 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` 파일에 아래 내용을 추가하세요:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**설정 파일 위치:**
-| 범위 | 경로 |
-|------|------|
-| 프로젝트 | `<프로젝트>/.gemini/settings.json` |
-| 글로벌 | `~/.gemini/settings.json` |
-
-### 방법 3: 환경 변수 사용
-
-특정 환경 변수가 필요한 경우:
-
-**CLI:**
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
-```
-
-**설정 파일:**
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_PORT": "3002"
-      }
-    }
-  }
-}
-```
-
-## 연결 테스트
-
-1. **Roblox Studio** 실행 → Plugins 탭 → **WEPPY** → **Connect**
-2. **Gemini CLI** 실행 후 다음을 입력:
-   ```
-   Roblox Studio에서 현재 선택된 것을 알려줘
-   ```
-
-## MCP 서버 상태 확인
-
-Gemini CLI 내에서 `/mcp` 명령으로 연결된 서버 상태를 확인할 수 있습니다:
-
-```
-/mcp
-```
-
-## 문제 해결
-
-### 서버가 시작되지 않을 때
-
-MCP 서버를 직접 실행하여 오류를 확인하세요:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### 연결 실패
-
-- Roblox Studio 플러그인이 **Connected** 상태인지 확인
-- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
-- `/mcp` 명령으로 서버 상태 확인
-
-### 도구 충돌
-
-여러 MCP 서버에서 같은 이름의 도구가 있으면 `serverAlias__toolName` 형식으로 프리픽스가 붙습니다.
-
-## 참고 자료
-
-- [Gemini CLI MCP 공식 문서](https://geminicli.com/docs/tools/mcp-server/)
-- [Gemini CLI 설정 가이드](https://geminicli.com/docs/get-started/configuration/)