vscode-mcp
vscode-mcp
一个 MCP (Model Context Protocol) 服务器,为 VS Code 和 Cursor 提供 Claude IDE 功能。Claude 可以直接在聊天中读取、写入、编辑、搜索和运行工作区中的命令。
工具
工具 | 描述 |
| 读取文件内容,支持可选的行范围 |
| 写入或覆盖文件(自动创建父目录) |
| 替换文件中的精确字符串 |
| 列出文件和目录(支持递归) |
| 创建目录树 |
| 删除文件或目录 |
| 移动或重命名文件/目录 |
| 在文件中进行 Grep 风格的正则搜索 |
| 通过 glob 模式查找文件(例如 |
| 执行任何 Shell 命令并捕获输出 |
| 获取平台、Node 版本、git 分支及状态 |
| 获取文件元数据(大小、修改时间、类型) |
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 Settings → Features → MCP 并点击 Refresh(或重启 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接受任何 Shell 命令 — 可用于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.15305MIT
- 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