@cano721/mysql-mcp-server 0.1.6 → 0.1.8

package/README.md

@@ -18,9 +18,18 @@
 
 ## 설치
 
-### 1. 다음 방법 중 하나로 설치:
+### 방법 1: npx 사용 (권장 - 설치 불필요)
 
-#### NPM에서 설치
+`npx`를 사용하면 별도 설치 없이 바로 사용할 수 있습니다:
+
+```bash
+# 설치 없이 바로 사용 가능
+npx @cano721/mysql-mcp-server
+```
+
+### 방법 2: 전역 설치
+
+자주 사용하거나 오프라인에서 사용하려면 전역 설치:
 
 ```bash
 # 전역 설치
@@ -30,7 +39,9 @@ npm install -g @cano721/mysql-mcp-server
 npm install @cano721/mysql-mcp-server
 ```
 
-#### 소스에서 빌드
+### 방법 3: 소스에서 빌드
+
+개발이나 커스터마이징이 필요한 경우:
 
 ```bash
 # 저장소 복제
@@ -42,7 +53,7 @@ npm install
 npm run build
 ```
 
-#### Smithery를 통한 설치
+### 방법 4: Smithery를 통한 설치
 
 Claude AI용 MySQL 데이터베이스 접근 MCP 서버를 Smithery를 통해 자동으로 설치:
 
@@ -64,7 +75,7 @@ npx -y @smithery/cli install @cano721/mysql-mcp-server --client claude
 
 MCP 설정 파일에 다음 구성을 추가하세요:
 
-npm으로 설치한 경우 (옵션 1):
+npx 사용 시 (권장):
 ```json
 {
   "mcpServers": {
@@ -85,7 +96,7 @@ npm으로 설치한 경우 (옵션 1):
 }
 ```
 
-소스에서 빌드한 경우 (옵션 2):
+소스에서 빌드한 경우:
 ```json
 {
   "mcpServers": {
@@ -361,6 +372,80 @@ Cursor IDE에서 MCP 서버를 사용하려면 `.cursor/mcp.json` 파일을 생
 - **권한 오류**: MySQL 사용자에게 데이터베이스 접근 권한이 있는지 확인
 - **쿼리 오류**: SELECT, SHOW, DESCRIBE, EXPLAIN 문만 사용 가능
 
+### npx 관련 문제
+
+#### 1. npx 캐시 문제
+```bash
+# 최신 버전 강제 사용
+npx --yes @cano721/mysql-mcp-server@latest
+
+# npm 캐시 클리어
+npm cache clean --force
+```
+
+#### 2. 환경 변수 전달 문제
+MCP 설정에서 환경 변수가 제대로 설정되었는지 확인:
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "npx",
+      "args": ["@cano721/mysql-mcp-server"],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "4307",
+        "MYSQL_USER": "developer"
+      }
+    }
+  }
+}
+```
+
+#### 3. Node.js PATH 문제
+```bash
+# Node.js 경로 확인
+which node
+which npx
+
+# PATH에 Node.js 추가 (필요시)
+export PATH="/path/to/node/bin:$PATH"
+```
+
+#### 4. 대안: 전역 설치 사용
+npx가 계속 문제가 되면 전역 설치 후 직접 실행:
+```bash
+npm install -g @cano721/mysql-mcp-server
+```
+
+그 후 MCP 설정에서:
+```json
+{
+  "mcpServers": {
+    "mysql": {
+      "command": "mysql-mcp-server",
+      "args": [],
+      "env": {
+        "MYSQL_HOST": "localhost",
+        "MYSQL_PORT": "4307",
+        "MYSQL_USER": "developer"
+      }
+    }
+  }
+}
+```
+
+#### 5. 연결 테스트
+터미널에서 직접 테스트:
+```bash
+# 환경 변수 설정 후 테스트
+export MYSQL_HOST=localhost
+export MYSQL_PORT=4307
+export MYSQL_USER=developer
+
+# MCP 서버 테스트
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @cano721/mysql-mcp-server
+```
+
 ## 라이선스
 
 이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다 - 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cano721/mysql-mcp-server",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "An MCP server that provides read-only access to MySQL databases.",
   "type": "module",
   "bin": {