클로드 데스크톱 MCP

프로젝트 지침 설정

Claude Desktop에서 새 프로젝트를 생성한 후, 프로젝트 지침에 다음과 같은 내용을 포함시켜 MCP 기능을 활성화할 수 있습니다:

너는 MCP를 사용할 수 있어.
                다음 예시들을 살펴보고 적절히 활용해줘.
                
                Node.js & Git
                { "tool": "terminal", "parameters": { "cmd": "npm install express" } }
                { "tool": "terminal", "parameters": { "cmd": "node server.js" } }
                { "tool": "terminal", "parameters": { "cmd": "git clone https://github.com/user/repo.git" } }
                
                파이썬 개발 도구
                { "tool": "terminal", "parameters": { "cmd": "python --version" } }
                { "tool": "terminal", "parameters": { "cmd": "pip install requests" } }
                { "tool": "terminal", "parameters": { "cmd": "pipx install black" } }
                { "tool": "terminal", "parameters": { "cmd": "pipenv install" } }
                { "tool": "terminal", "parameters": { "cmd": "poetry add numpy" } }
                { "tool": "terminal", "parameters": { "cmd": "pytest tests/" } }
                { "tool": "terminal", "parameters": { "cmd": "tox" } }
                { "tool": "terminal", "parameters": { "cmd": "flake8 src/" } }
                { "tool": "terminal", "parameters": { "cmd": "pylint module.py" } }
                { "tool": "terminal", "parameters": { "cmd": "black ." } }
                { "tool": "terminal", "parameters": { "cmd": "isort ." } }
                { "tool": "terminal", "parameters": { "cmd": "mypy app.py" } }
                { "tool": "terminal", "parameters": { "cmd": "coverage run -m pytest" } }
                { "tool": "terminal", "parameters": { "cmd": "python -m cProfile script.py" } }
                { "tool": "terminal", "parameters": { "cmd": "pyinstrument script.py" } }
                
                성능·부하 테스트 도구
                { "tool": "terminal", "parameters": { "cmd": "ab -n 1000 -c 10 http://localhost:3000/" } }
                { "tool": "terminal", "parameters": { "cmd": "wrk -t2 -c100 -d30s http://localhost:3000/" } }
                { "tool": "terminal", "parameters": { "cmd": "siege -c25 -t1M http://localhost:3000/" } }
                { "tool": "terminal", "parameters": { "cmd": "locust -f locustfile.py" } }
                { "tool": "terminal", "parameters": { "cmd": "k6 run script.js" } }
                { "tool": "terminal", "parameters": { "cmd": "hey -n1000 -c50 http://localhost:3000/" } }
                { "tool": "terminal", "parameters": { "cmd": "pytest --benchmark-only" } }
                
                 기타 유틸리티
                { "tool": "terminal", "parameters": { "cmd": "curl https://api.example.com/data" } }
                { "tool": "terminal", "parameters": { "cmd": "http GET https://api.example.com/data" } }
                { "tool": "terminal", "parameters": { "cmd": "ls -la" } }
                { "tool": "terminal", "parameters": { "cmd": "dir" } }
                
                // MySQL 예시 (terminal tool 사용)
                [
                  { "tool": "terminal",
                    "parameters": {
                      "cmd": "mysql -uroot -p -e \"SHOW TABLES;\" shorts_generator"
                    }
                  },
                  { "tool": "terminal",
                    "parameters": {
                      "cmd": "mysql -uroot -p -e \"SELECT id, title FROM videos LIMIT 5;\" shorts_generator"
                    }
                  },
                  { "tool": "terminal",
                    "parameters": {
                      "cmd": "mysql -uroot -p -e \"INSERT INTO videos (title, description) VALUES ('샘플','테스트');\" shorts_generator"
                    }
                  },
                  { "tool": "terminal",
                    "parameters": {
                      "cmd": "mysql -uroot -p -e \"BEGIN; UPDATE videos SET view_count = view_count + 1 WHERE id = 42; COMMIT;\" shorts_generator"
                    }
                  }
                ]
                
                
                
                
                Playwright MCP Server 사용 예시
                페이지 열기
                { "tool":"playwright","parameters":{"action":"goto","url":"https://example.com"}} ,
                로그인 버튼 클릭
                { "tool":"playwright","parameters":{"action":"click","selector":"#login-button"}} ,
                검색어 입력 후 엔터
                { "tool":"playwright","parameters":{"action":"fill","selector":"input[name='q']","text":"MCP Server"}} ,
                { "tool":"playwright","parameters":{"action":"press","selector":"input[name='q']","key":"Enter"}} ,
                페이지 스크린샷 저장
                { "tool":"playwright","parameters":{"action":"screenshot","path":"search-results.png"}} ,
                콘솔 에러 로그 수집
                { "tool":"playwright","parameters":{"action":"getConsoleLogs"}} ,
                네트워크 요청 내역 수집
                { "tool":"playwright","parameters":{"action":"getNetworkRequests"}} ,
                JS 평가(페이지 타이틀 가져오기)
                { "tool":"playwright","parameters":{"action":"evaluate","expression":"document.title"}} ,
                접근성 스냅샷(구조화된 DOM)
                { "tool":"playwright","parameters":{"action":"accessibilitySnapshot"}}
                
                
                다음 지침을 지켜줘.
                
                1. 폴더 및 파일 생성 및 수정은 C:\xampp\htdocs\mysite 폴더에 대해 진행해줘.
                2. 작업이 진행될 때마다, 그에 맞게 docs/project_plan.md 파일을 업데이트해줘.
                3. mysite 폴더에는 이미 생성된 파일들이 있어. 기존에 존재하는 파일들 확인하여 작업 진행해야 해. 
                4. 소스들이 많아 꼭 필요한 파일들만 읽은 후, 편집 또는 추가로 진행해줘. 긴 파일은 2개나 3개로 나누어서 작업해줘.
                5. 각 파일이 18kb를 초과하지 않도록 긴 내용은 미리 여러 개의 파일로 기획하여 진행해줘.
                6. docs 폴더에 파일을 업데이트하거나 생성할 때, 꼭 필요한 내용만 넣어서 용량을 줄여줘.
                7. project_plan.md 파일에는 프로젝트 중요 사항 및 완료된 일, 해야할 일이 기록되어야 해.
                8. 테스트 진행할 때는 MCP 도구를 이용해 진행해줘. localhost로 브라우저를 띄우고 각 메뉴도 클릭하고 하나씩 눌러보면서 진행해줘.
                9. 쿼리 실행 등 DB 연결을 위해 mysql 쓸 때는 다음처럼 해봐.
                { args: [ -u, root, -e, \"SHOW DATABASES;\" ], command: mysql }
                (중요한 점으로, "SHOW DATABASES;" 이 문구는 양 옆에 따옴표 있어야 해. 필수야)
                
                10. C:\xampp\htdocs\mysite 폴더는 http://localhost를 가리켜. 따라서 http://localhost 접속시 C:\xampp\htdocs\mysite 폴더의 인덱스 파일이 뜨게 돼. 
                11. 로그 정보가 C:\xampp\htdocs\mysite\logs 이곳에 쌓이도록 PHP 개발을 진행해야 해. 그리고 너는 logs 폴더의 내용을 통해 오류 확인해야 해.
                12. 자바스크립트 작성 시, 이벤트마다 콘솔에 로그를 남겨야 해. 그래야 에러 발생시 원인을 찾을 수 있어. 
                13. 디버깅 시, 콘솔의 로그를 찾아봐.
                14. (개발이 진행되어 필요한 경우, 이 내용 넣으세요.) 테스트를 위해 다음 사용자 정보 사용해 로그인할 것
                아이디: example@example.com
                비밀번호: testpassword
                15. 작업을 임의로 진행하지 말고, 작업 전에 반드시 동의를 받아야 해.
                16. 너는 하라고 한 구체적인 사항은 진행하고 무조건 대기해야 해. 명시적으로 시킨것만 해줘.

웹 개발 환경 설정 (XAMPP)

웹 개발과 데이터베이스를 사용하려면 XAMPP를 설정할 수 있습니다:

1. XAMPP 설치 (MySQL 옵션 체크)
2. XAMPP 컨트롤 패널에서 Apache와 MySQL 시작
3. 기본 웹 페이지 경로 변경하기 (선택사항)
   • 새 폴더 생성: C:\xampp\htdocs\mysite
   • 설정 파일 수정: C:\xampp\apache\conf\httpd.conf 열기
   • 다음 내용을 찾아 수정:

     DocumentRoot "C:/xampp/htdocs"
     <Directory "C:/xampp/htdocs">

     아래와 같이 변경:

     DocumentRoot "C:/xampp/htdocs/mysite"
     <Directory "C:/xampp/htdocs/mysite">

   • Apache와 MySQL 재시작
4. MCP 설정 파일에서 filesystem 경로를 웹 폴더로 지정

   "filesystem": {
     "command": "npx",
     "args": [
       "-y",
       "@modelcontextprotocol/server-filesystem",
       "C:\\xampp\\htdocs\\mysite"
     ]
   }

MCP 기능 활용법

1. 프로젝트 플랜 파일 관리
   • 프로젝트 진행 상황을 project_plan.md 파일에 기록
   • 작업 진행 내용, 완료된 작업, 다음 단계 등을 포함
   • Claude가 중단되어도 이 파일을 통해 다음 세션에서 작업 계속 진행 가능
2. 웹 브라우징 MCP 활용
   • 웹사이트 접속, 로그인, 클릭, 스크린샷 등 자동화
   • 콘솔 로그 확인을 통한 디버깅
   • 에러 추적 및 자동 분석
3. 데이터베이스 연동
   • MySQL 명령어를 통한 데이터베이스 관리
   • 쿼리 실행 및 결과 분석
   • 세션 및 데이터 관리
4. 파일 분할 관리
   • 파일이 너무 커지면 여러 개로 나누어 관리 (18KB 제한)
   • 효율적인 프로젝트 구조 설계