Skip to main content
Glama

vscode-mcp

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

도구

도구

설명

read_file

파일 내용을 읽습니다 (선택적으로 줄 범위 지정 가능)

write_file

파일을 쓰거나 덮어씁니다 (상위 디렉터리 생성)

edit_file

파일 내의 정확한 문자열을 교체합니다

list_directory

파일 및 디렉터리 목록을 표시합니다 (선택적으로 재귀적 탐색 가능)

create_directory

디렉터리 트리를 생성합니다

delete_path

파일이나 디렉터리를 삭제합니다

move_path

파일/디렉터리를 이동하거나 이름을 변경합니다

search_files

파일 전체에서 Grep 스타일의 정규식 검색을 수행합니다

find_files

glob 패턴(예: *.ts)으로 파일을 찾습니다

run_command

모든 셸 명령을 실행하고 출력을 캡처합니다

get_workspace_info

플랫폼, Node 버전, git 브랜치 및 상태 정보를 가져옵니다

get_file_info

파일 메타데이터(크기, 수정 시간, 유형)를 가져옵니다

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 및 숨겨진 폴더를 자동으로 건너뜁니다.

Available Tools

12 tools
create_directoryA

Create a directory (and all parent directories).

Inputs: path (required), workspace_root.

delete_pathB

Delete a file or directory.

Inputs: path (required), recursive, workspace_root.

edit_fileC

Replace an exact string in a file. The old_string must appear exactly once.

Inputs: path (required), old_string (required), new_string (required), workspace_root.

find_filesB

Find files by name glob pattern (e.g. '.ts', 'index.').

Inputs: directory (required), pattern (required), max_results, workspace_root.

get_file_infoB

Get metadata about a file or directory (size, modification time, type).

Inputs: path (required), workspace_root.

get_workspace_infoA

Get information about the current workspace: root directory, platform, Node version, git status summary.

Inputs: workspace_root.

list_directoryB

List files and directories at a given path.

Inputs: path (required), recursive, workspace_root.

move_pathB

Move or rename a file or directory.

Inputs: source (required), destination (required), workspace_root.

read_fileB

Read the contents of a file. Optionally specify a line range.

Inputs: path (required), start_line, end_line, workspace_root.

run_commandA

Execute a shell command in the given working directory. Returns stdout, stderr, and exit code.

Inputs: command (required), cwd, timeout_ms.

search_filesB

Search for a regex pattern inside files. Returns matching lines with file and line number.

Inputs: directory (required), pattern (required), file_glob, ignore_case, +2 more.

write_fileA

Write or overwrite a file with new content. Creates parent directories automatically.

Inputs: path (required), content (required), workspace_root.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a distinct file or workspace operation: create, delete, edit, find, get info, list, move, read, run, search, write. No two tools have overlapping purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_directory, read_file, write_file). No deviations or mixed conventions.

    Tool Count5/5

    12 tools is well-scoped for a file system and workspace utility server, covering essential operations without being overwhelming or too sparse.

    Completeness4/5

    The tool set covers fundamental file/directory operations and workspace info. Minor gaps exist such as no copy tool (can be done via read+write) and no line-based editing, but core workflows are supported.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
      15
      306
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that provides dynamic codebase context to Claude Code through tools like hybrid search, recent changes, and symbol definitions, enhancing AI-assisted coding with local RAG.
      8
      35 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that integrates with VS Code to enable file operations, git diffs, and line highlighting via MCP clients like Claude.
      43
      MIT