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: AiDD MCP Server

📦 Installation

Prerequisites

• Node.js 18.0.0 or higher

• Claude Desktop (or any MCP-compatible client)

Setup

1. Clone the repository:

   git clone <your-repo-url>
   cd vs-code-mcp-server

2. Install dependencies:

   npm install

3. Build 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-server with the actual path to your cloned repository.

🛠️ Available Tools

📁 File Operations (8 tools)

⚡ Advanced File Operations (6 tools)

🖥️ Command Execution (8 tools)

📊 Project Analysis (3 tools)

🔍 VS Code Integration (4 tools)

🔧 Development

Scripts

• npm run build - Build the TypeScript source

• npm run start - Start the MCP server

• npm run dev - Build and start in development mode

• npm run watch - Watch for changes and rebuild automatically

• npm 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

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. 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:

1. Check the Issues section

2. Create a new issue with detailed information

3. 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