vs-code-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@vs-code-mcp-server Search for 'TODO' in the codebase"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VS Code MCP Server
A comprehensive Model Context Protocol (MCP) server designed to provide AI assistants with powerful VS Code integration capabilities, offering 29 specialized tools for file operations, command execution, project analysis, and development workflow automation.
š Features
š File Operations: Complete file and directory management (8 tools)
ā” Advanced File Editing: Precise line-level editing with validation (6 tools)
š„ļø Command Execution: System command execution and process management (8 tools)
š Project Analysis: Codebase insights and dependency discovery (3 tools)
š VS Code Integration: Symbol search, definitions, and diagnostics (4 tools)
Related MCP server: MCP Server for VS Code
š¦ Installation
Prerequisites
Node.js 18.0.0 or higher
Claude Desktop (or any MCP-compatible client)
Setup
Clone the repository:
git clone <your-repo-url> cd vs-code-mcp-serverInstall dependencies:
npm installBuild the server:
npm run build
Configuration
Add the server to your MCP client configuration. For Claude Desktop, edit the config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"vs-code-mcp-server": {
"command": "node",
"args": ["/path/to/your/vs-code-mcp-server/dist/index.js"],
"env": {}
}
}
}Note: Replace
/path/to/your/vs-code-mcp-serverwith the actual path to your cloned repository.
š ļø Available Tools
š File Operations (8 tools)
Tool | Description |
| List files and directories with optional recursive listing |
| Read file contents with encoding and line range options |
| Create new files with overwrite protection |
| Delete files and directories with recursive options |
| Copy files and directories to new locations |
| Move or rename files and directories |
| Create directories with recursive parent creation |
| Search for text patterns across files with regex support |
ā” Advanced File Operations (6 tools)
Tool | Description |
| Replace specific lines with content validation |
| Insert content at specific line positions |
| Delete specific line ranges from files |
| Append content to file end |
| Prepend content to file beginning |
| Advanced find/replace with regex support |
š„ļø Command Execution (8 tools)
Tool | Description |
| Execute shell commands with timeout control |
| Execute commands with real-time output streaming |
| Kill processes by PID or name |
| List running processes with filtering |
| Kill multiple processes matching patterns |
| Check command availability on system |
| Get comprehensive system information |
| Execute script files with appropriate interpreters |
š Project Analysis (3 tools)
Tool | Description |
| Analyze project structure and provide insights |
| Get detailed codebase statistics |
| Discover and analyze project dependencies |
š VS Code Integration (4 tools)
Tool | Description |
| Search for symbols across workspace with fuzzy matching |
| Get symbol definitions with type information |
| Get hierarchical symbol outline for files |
| Analyze code for errors and warnings |
š§ Development
Scripts
npm run build- Build the TypeScript sourcenpm run start- Start the MCP servernpm run dev- Build and start in development modenpm run watch- Watch for changes and rebuild automaticallynpm run test- Run the test suite
Project Structure
src/
āāā index.ts # Main server implementation
āāā tools/ # Tool definitions and handlers
ā āāā file-tools.ts # Basic file operations
ā āāā advanced-file-tools.ts # Advanced file editing
ā āāā command-tools.ts # Command execution
ā āāā project-tools.ts # Project analysis
ā āāā vscode-integration-tools.ts # VS Code features
āāā types/ # TypeScript type definitions
āāā utils/ # Utility functions
ā āāā file-utils.ts # File operation utilities
ā āāā command-utils.ts # Command execution utilities
ā āāā file-watcher.ts # File watching capabilities
ā āāā logger.ts # Logging utilitiesš Security
This MCP server is designed for defensive development tasks only. It includes:
Input validation and sanitization
Safe file operation boundaries
Process execution controls
Error handling and logging
š¤ Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
š License
This project is licensed under the MIT License - see the LICENSE file for details.
š Issues & Support
If you encounter any issues or have questions:
Check the Issues section
Create a new issue with detailed information
Include error logs and configuration details
š Acknowledgments
Built with the Model Context Protocol SDK
Designed for integration with Claude Desktop
Supports VS Code development workflows
Available Tools
29 toolsanalyze_projectC
Analyze project structure and provide insights about the codebase
Inputs: maxDepth, directory, includeHidden.
append_to_file_codeB
Append content to the end of a file
Inputs: path (required), content (required).
check_command_codeA
Check if a command is available on the system
Inputs: command (required).
copy_file_codeB
Copy a file or directory to another location
Inputs: source (required), destination (required), overwrite.
create_directory_codeC
Create a new directory
Inputs: path (required), recursive.
create_file_codeC
Create a new file or overwrite an existing file with content
Inputs: path (required), content (required), overwrite, ignoreIfExists.
delete_file_codeB
Delete a file or directory
Inputs: path (required), recursive.
delete_lines_codeB
Delete specific lines from a file
Inputs: path (required), endLine (required), startLine (required).
execute_shell_command_codeC
Execute shell commands in VS Code integrated terminal
Inputs: command (required), cwd, timeout.
execute_streaming_command_codeC
Execute shell commands with streaming output
Inputs: command (required), cwd, timeout.
find_and_replace_codeA
Find and replace text patterns in a file with regex support
Inputs: path (required), replaceWith (required), searchPattern (required), isRegex, +2 more.
find_dependenciesC
Find and analyze project dependencies
Inputs: directory.
get_diagnostics_codeC
Analyzes code for warnings and errors using integrated linters
Inputs: path, format, severities, includeSource.
get_document_symbols_codeA
Gets complete symbol outline for a file showing hierarchical structure and line numbers
Inputs: path (required), maxDepth.
get_project_statsC
Get detailed statistics about the project codebase
Inputs: directory, includeTests.
get_symbol_definition_codeB
Gets definition information for a symbol using hover data (type, docs, source)
Inputs: line (required), path (required), symbol (required).
get_system_info_codeA
Get system information including OS, CPU, memory, and disk usage
Inputs: no named parameters.
insert_lines_codeB
Insert new lines at a specific position in a file
Inputs: line (required), path (required), content (required).
kill_all_processes_codeB
Kill all processes matching a pattern (use with caution)
Inputs: pattern (required), signal, excludeOwn.
kill_process_codeA
Kill a process by PID or name
Inputs: pid, name, signal.
list_files_codeA
List files and directories in a specified path with optional recursive listing
Inputs: path (required), recursive.
list_processes_codeB
List running processes with filtering options
Inputs: filter, maxResults.
move_file_codeB
Move or rename a file or directory
Inputs: source (required), destination (required).
prepend_to_file_codeA
Prepend content to the beginning of a file
Inputs: path (required), content (required).
read_file_codeA
Read the contents of a file with optional encoding and line range
Inputs: path (required), endLine, encoding, startLine, +1 more.
replace_lines_codeB
Replace specific lines in existing files with exact content validation
Inputs: path (required), content (required), endLine (required), startLine (required), +1 more.
run_script_codeC
Run a script file with the appropriate interpreter
Inputs: scriptPath (required), cwd, args, timeout.
search_files_codeC
Search for text patterns in files within a directory
Inputs: pattern (required), directory, maxResults, filePattern, +1 more.
search_symbols_codeA
Search for symbols (functions, classes, variables) across workspace using fuzzy matching
Inputs: query (required), maxResults.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 29 tools
Most tools have clearly distinct purposes, such as file operations versus process management. However, execute_shell_command_code and execute_streaming_command_code are similar, and several file editing tools (replace_lines, insert_lines, find_and_replace) could be confused despite their specific descriptions.
The majority of tools follow a verb_noun_code pattern (e.g., list_files_code, read_file_code). However, a few tools omit the '_code' suffix (analyze_project, get_project_stats, find_dependencies), creating inconsistency in the naming convention.
With 29 tools, the server pushes beyond the typical upper bound for a well-scoped toolset. The breadth of file, code analysis, and system operations justifies a large surface, but the count feels excessive and could overwhelm agents.
The toolset provides comprehensive coverage for file operations (create, read, update, delete, search) and code analysis (symbols, diagnostics, project insights). Minor gaps exist, such as no direct tool to inspect file metadata or manage editor tabs, but these are not critical for the domain.
Maintenance
Related MCP Connectors
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Read and write KukGit repositories, files, issues and pull requests from an AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI-driven development tools including file system operations, multi-language code analysis with tree-sitter, Git operations, code execution, and system information retrieval.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with VS Code for language intelligence, debugging, and code execution.17MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage project analysis, code metrics, documentation, Git operations, code quality, and file organization through natural language commands.2MIT
- AlicenseAqualityDmaintenanceEnables AI agents to control VSCode workspaces, including file operations, terminal commands, search, and workspace management.7MIT