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

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.

VSC as MCP