🔌 VSC as MCP

🚀 Supercharge your AI coding assistants with VS Code's powerful language intelligence!

A Visual Studio Code extension that exposes an MCP (Model Context Protocol) server, giving AI tools like Claude, Cursor, and others direct access to VS Code's semantic code understanding capabilities - go-to-definition, find references, completions, diagnostics, and so much more!

✨ Features

🧠 Full Language Intelligence - Access VS Code's language server features via MCP tools
📁 Workspace Aware - Works on individual files or full project contexts
🔗 URI Protocol Handler - Launch VS Code via vscode://codingwithcalvin.mcp/...
⚡ Auto-start - MCP server starts automatically when VS Code launches
🔒 Secure by Default - Binds only to localhost, no external access

🛠️ Available Tools

Tool	Description
📂 `vscode_open_folder`	Open a workspace folder
📋 `vscode_get_open_folders`	Get currently open workspace folder(s)
🏷️ `vscode_document_symbols`	Get all symbols in a document
🔍 `vscode_workspace_symbols`	Search symbols across the workspace
🎯 `vscode_go_to_definition`	Find symbol definitions
🔗 `vscode_find_references`	Find all references to a symbol
💡 `vscode_hover_info`	Get type info and documentation
⚠️ `vscode_diagnostics`	Get errors and warnings
📞 `vscode_call_hierarchy`	Get incoming/outgoing calls
✏️ `vscode_completions`	Get code completions at a position
📝 `vscode_signature_help`	Get function signature help
🏗️ `vscode_type_hierarchy`	Get type hierarchy information
🔧 `vscode_code_actions`	Get available code actions/quick fixes
🎨 `vscode_format_document`	Format an entire document
✂️ `vscode_format_range`	Format a specific range
📦 `vscode_organize_imports`	Organize imports in a document
✏️ `vscode_rename_symbol`	Rename a symbol across the workspace
🔎 `vscode_workspace_file_search`	Search for files by pattern
📄 `vscode_workspace_text_search`	Search for text across files

📦 Installation

From VS Code Marketplace

Open VS Code
Go to Extensions (Ctrl+Shift+X)
Search for "VSC as MCP"
Click Install

Manual Installation

Download the latest .vsix from the Releases page:

code --install-extension CodingWithCalvin.VSC-MCPServer.vsix

🎯 Usage

The MCP server starts automatically when VS Code launches! Just configure your AI tool to connect:

MCP Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "vscode": {
      "url": "http://localhost:4000/mcp",
      "description": "VS Code semantic code navigation"
    }
  }
}

URI Protocol

Launch VS Code and control the MCP server via URI:

vscode://codingwithcalvin.mcp/start                     # Start MCP server
vscode://codingwithcalvin.mcp/start?port=4000           # Start on specific port
vscode://codingwithcalvin.mcp/open?folder=/path/to/dir  # Open folder and start

⚙️ Configuration

Setting	Default	Description
`codingwithcalvin.mcp.autoStart`	`true`	🚀 Auto-start server on VS Code launch
`codingwithcalvin.mcp.port`	`4000`	🔌 MCP server port
`codingwithcalvin.mcp.bindAddress`	`127.0.0.1`	🔒 Bind address (localhost only)

💻 Commands

Access these from the Command Palette (Ctrl+Shift+P):

▶️ MCP Server: Start - Start the MCP server
⏹️ MCP Server: Stop - Stop the MCP server
🔄 MCP Server: Restart - Restart the MCP server
📋 MCP Server: Show Available Tools - View all available MCP tools

🔒 Security

🏠 Localhost Only - Binds only to 127.0.0.1
🛡️ DNS Rebinding Protection - Validates Host header
✅ Same-machine Trusted - No authentication required for local access

📋 Requirements

💻 Visual Studio Code 1.85.0 or later
🟢 Node.js (bundled with VS Code)

🤝 Contributing

Contributions are welcome! Whether it's bug reports, feature requests, or pull requests - all feedback helps make this extension better. 💪

Development Setup

🍴 Clone the repository
📦 Run npm install
🔨 Run npm run build
▶️ Press F5 to launch the Extension Development Host

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Contributors

⭐ If you find VSC as MCP useful, please consider giving it a star! ⭐

Made with ❤️ for the VS Code community by Coding With Calvin