vscode-mcp

VS Code 및 Cursor 내에서 Claude에게 IDE 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. Claude는 채팅에서 직접 워크스페이스의 파일을 읽고, 쓰고, 편집하고, 검색하고, 명령을 실행할 수 있습니다.

도구

Related MCP server: code-context

설치

npm install
npm run build

Cursor와 함께 사용하기

Cursor는 다음 위치에서 MCP 서버 구성을 읽습니다:

• 전역: ~/.cursor/mcp.json

• 프로젝트: .cursor/mcp.json (프로젝트 루트)

옵션 A — node를 통해 실행 (빌드 후)

Cursor MCP 구성에 다음을 추가하세요:

{
  "mcpServers": {
    "vscode-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/vscode-mcp/dist/index.js"]
    }
  }
}

옵션 B — npx를 통해 실행 (수동 빌드 불필요)

{
  "mcpServers": {
    "vscode-mcp": {
      "command": "npx",
      "args": ["--yes", "vscode-mcp"]
    }
  }
}

구성을 편집한 후 Cursor 설정 → 기능 → MCP를 열고 새로 고침을 클릭하세요 (또는 Cursor를 다시 시작하세요).

VS Code + Copilot Chat과 함께 사용하기 (MCP 지원)

VS Code의 settings.json에 다음을 추가하세요:

"mcp": {
  "servers": {
    "vscode-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/vscode-mcp/dist/index.js"]
    }
  }
}

개발

npm run dev    # watch mode (recompiles on save)
npm start      # run the built server

팁

• 모든 경로는 절대 경로이거나 워크스페이스 루트 기준 상대 경로일 수 있습니다.

• 상대 경로를 특정 디렉터리에 고정하려면 도구에 workspace_root를 전달하세요.

• run_command는 모든 셸 명령을 허용합니다. git, npm, 린터, 컴파일러 등에 사용하세요.

• search_files는 node_modules, dist 및 숨겨진 폴더를 자동으로 건너뜁니다.