@cano721/mysql-mcp-server 0.1.7 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +74 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -372,6 +372,80 @@ Cursor IDE에서 MCP 서버를 사용하려면 `.cursor/mcp.json` 파일을 생
|
|
|
372
372
|
- **권한 오류**: MySQL 사용자에게 데이터베이스 접근 권한이 있는지 확인
|
|
373
373
|
- **쿼리 오류**: SELECT, SHOW, DESCRIBE, EXPLAIN 문만 사용 가능
|
|
374
374
|
|
|
375
|
+
### npx 관련 문제
|
|
376
|
+
|
|
377
|
+
#### 1. npx 캐시 문제
|
|
378
|
+
```bash
|
|
379
|
+
# 최신 버전 강제 사용
|
|
380
|
+
npx --yes @cano721/mysql-mcp-server@latest
|
|
381
|
+
|
|
382
|
+
# npm 캐시 클리어
|
|
383
|
+
npm cache clean --force
|
|
384
|
+
```
|
|
385
|
+
|
|
386
|
+
#### 2. 환경 변수 전달 문제
|
|
387
|
+
MCP 설정에서 환경 변수가 제대로 설정되었는지 확인:
|
|
388
|
+
```json
|
|
389
|
+
{
|
|
390
|
+
"mcpServers": {
|
|
391
|
+
"mysql": {
|
|
392
|
+
"command": "npx",
|
|
393
|
+
"args": ["@cano721/mysql-mcp-server"],
|
|
394
|
+
"env": {
|
|
395
|
+
"MYSQL_HOST": "localhost",
|
|
396
|
+
"MYSQL_PORT": "4307",
|
|
397
|
+
"MYSQL_USER": "developer"
|
|
398
|
+
}
|
|
399
|
+
}
|
|
400
|
+
}
|
|
401
|
+
}
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
#### 3. Node.js PATH 문제
|
|
405
|
+
```bash
|
|
406
|
+
# Node.js 경로 확인
|
|
407
|
+
which node
|
|
408
|
+
which npx
|
|
409
|
+
|
|
410
|
+
# PATH에 Node.js 추가 (필요시)
|
|
411
|
+
export PATH="/path/to/node/bin:$PATH"
|
|
412
|
+
```
|
|
413
|
+
|
|
414
|
+
#### 4. 대안: 전역 설치 사용
|
|
415
|
+
npx가 계속 문제가 되면 전역 설치 후 직접 실행:
|
|
416
|
+
```bash
|
|
417
|
+
npm install -g @cano721/mysql-mcp-server
|
|
418
|
+
```
|
|
419
|
+
|
|
420
|
+
그 후 MCP 설정에서:
|
|
421
|
+
```json
|
|
422
|
+
{
|
|
423
|
+
"mcpServers": {
|
|
424
|
+
"mysql": {
|
|
425
|
+
"command": "mysql-mcp-server",
|
|
426
|
+
"args": [],
|
|
427
|
+
"env": {
|
|
428
|
+
"MYSQL_HOST": "localhost",
|
|
429
|
+
"MYSQL_PORT": "4307",
|
|
430
|
+
"MYSQL_USER": "developer"
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
}
|
|
434
|
+
}
|
|
435
|
+
```
|
|
436
|
+
|
|
437
|
+
#### 5. 연결 테스트
|
|
438
|
+
터미널에서 직접 테스트:
|
|
439
|
+
```bash
|
|
440
|
+
# 환경 변수 설정 후 테스트
|
|
441
|
+
export MYSQL_HOST=localhost
|
|
442
|
+
export MYSQL_PORT=4307
|
|
443
|
+
export MYSQL_USER=developer
|
|
444
|
+
|
|
445
|
+
# MCP 서버 테스트
|
|
446
|
+
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @cano721/mysql-mcp-server
|
|
447
|
+
```
|
|
448
|
+
|
|
375
449
|
## 라이선스
|
|
376
450
|
|
|
377
451
|
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다 - 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.
|