vscode-mcp
vscode-mcp
VS Code 및 Cursor 내에서 Claude에게 IDE 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. Claude는 채팅에서 직접 워크스페이스의 파일을 읽고, 쓰고, 편집하고, 검색하고, 명령을 실행할 수 있습니다.
도구
도구 | 설명 |
| 파일 내용을 읽습니다 (선택적으로 줄 범위 지정 가능) |
| 파일을 쓰거나 덮어씁니다 (상위 디렉터리 생성) |
| 파일 내의 정확한 문자열을 교체합니다 |
| 파일 및 디렉터리 목록을 표시합니다 (선택적으로 재귀적 탐색 가능) |
| 디렉터리 트리를 생성합니다 |
| 파일이나 디렉터리를 삭제합니다 |
| 파일/디렉터리를 이동하거나 이름을 변경합니다 |
| 파일 전체에서 Grep 스타일의 정규식 검색을 수행합니다 |
| glob 패턴(예: |
| 모든 셸 명령을 실행하고 출력을 캡처합니다 |
| 플랫폼, Node 버전, git 브랜치 및 상태 정보를 가져옵니다 |
| 파일 메타데이터(크기, 수정 시간, 유형)를 가져옵니다 |
Related MCP server: code-context
설치
npm install
npm run buildCursor와 함께 사용하기
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 toolscreate_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
Scored across 12 tools
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.
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.
12 tools is well-scoped for a file system and workspace utility server, covering essential operations without being overwhelming or too sparse.
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
Related MCP Connectors
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Hosted SQL Server MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn 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.15306MIT
- AlicenseAqualityDmaintenanceAn 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.835 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceMCP server that integrates with VS Code to enable file operations, git diffs, and line highlighting via MCP clients like Claude.43MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that allows Claude Desktop to remotely control Claude Code instances for executing commands and managing files.56 npmGPL 3.0