소개/소소한공부

클로드 데스크탑 설치 & MCP 환경설정

이영훈닷컴 2025. 4. 7. 17:20
728x90

1. 클로드 데스크탑 설치

오늘은 클로드 데스크탑을 설치해봤다.

  • 클로드 데스크탑은 UI 기반으로 MCP를 실행하거나 관리할 수 있는 도구.
  • 공식 사이트에서 설치 파일을 받아서 설치하면 된다.
  • 설치가 완료되면 바탕화면에 실행 아이콘이 생긴다.

느낀 점: GUI 기반이라 터미널이 어려운 사람도 접근하기 좋다.


2. Node.js 설치

클로드 데스크탑에서 MCP 실행 시 일부 기능은 Node.js가 필요하다고 해서 같이 설치했다.

  • Node.js 공식 사이트에서 LTS 버전으로 설치함.
  • 설치 후 터미널(명령 프롬프트)에 node -v 명령어 입력해서 잘 설치됐는지 확인함 → 버전 정보가 뜨면 성공!

팁: npm도 함께 설치되므로 패키지 설치도 쉽게 할 수 있다.


3. MCP 환경 설정

클로드 데스크탑을 열고 설정을 수정해봤다.

설정 파일 예시는 다음과 같음:

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\{이름}\\Desktop\\mcpsvr",
        "run",
        "imsi.py"
      ]
    },
    "remote-example": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8000/sse"]
    }
  }
}

설명:

  • mcpServers: MCP로 실행할 서버들 목록.
  • weather:
    • command: 실행 명령어 (uv)
    • args: 실행 옵션들.
      • "--directory": 실행할 폴더 경로 지정
      • "imsi.py": 실행할 파이썬 파일
  • remote-example:
    • npx를 통해 원격 MCP 연결 (URL은 임시 예시)

팁: 경로에 {이름} 부분은 내 윈도우 사용자 이름으로 바꿔야 한다. 예: 홍길동이라면 C:\\Users\\홍길동\\Desktop\\mcpsvr


마무리

오늘은 처음으로 클로드 데스크탑을 설치하고 MCP 서버 설정을 해봤다.
처음엔 헷갈렸지만, 하나씩 해보니까 생각보다 어렵지 않았다!

기억할 것

  • Node.js는 미리 설치해두면 여러 도구 사용에 유용함
  • 설정 파일은 JSON 형식이니 쉼표(,) 빠뜨리지 말자
  • 실행 명령어는 환경에 따라 다를 수 있으니 잘 확인하자
728x90