vscode-editor-mcp
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., "@vscode-editor-mcp What file and selection do I have open in VS Code?"
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 Editor MCP
A VS Code extension that exposes the editor's active file and selection(s) to CLI-based LLM coding agents — such as OpenCode and Crush — through a Model Context Protocol (MCP) server.
Why
CLI coding agents run outside the editor and have no direct way to know what you're looking at in VS Code. This extension bridges that gap: it continuously publishes the active editor's file path, language, and selection(s) to a shared state file, and an MCP server exposes that state through the get_selection tool. Any MCP-compatible CLI client can connect to the server and incorporate the current editor context into its prompts, so the agent sees the same file and selection you do without you having to copy-paste paths or line ranges.
Related MCP server: Code MCP Server
How it works
The extension and the MCP server run in separate processes and communicate through a shared JSON file (vscode-editor-mcp-state.json) in the OS temp directory:
Extension (
src/extension.ts) — runs inside VS Code, listens to editor events (active editor change, selection change), and writes the current state to the shared JSON file.MCP server (
src/server.ts) — a standalone stdio process that reads the JSON file and exposes theget_selectiontool to MCP clients.
Provided tool
get_selection
Returns the name and path of the file open in VS Code's active editor along with the line range(s) of the current selection(s). Line and character numbers are 1-based.
Prerequisites
Install
Windows (PowerShell)
./install.ps1The script installs dependencies, builds the TypeScript, packages a .vsix, and installs it into VS Code. Use -NoInstall to skip installing into VS Code, or -CodeCommand to target a different editor CLI (e.g. code-insiders, codium).
Manual
npm install
npm run build
npx @vscode/vsce package --allow-missing-repository
code --install-extension vscode-editor-mcp-0.1.0.vsixConfigure an MCP client
Point your MCP client at the packaged server. The server binary is out/server.js (also exposed as the vscode-editor-mcp-server bin entry).
Example client configuration (stdio transport):
{
"mcpServers": {
"vscode-editor-mcp": {
"command": "node",
"args": ["C:/source/vscode_mcp/out/server.js"]
}
}
}Reload VS Code after installing so the extension starts writing editor state.
Commands
VS Code Editor MCP: Show Current Editor State — prints the active file name and selection count. Useful for verifying the extension is running.
Build
npm run build # compile to out/
npm run watch # recompile on changeLicense
MIT
Available Tools
1 toolget_selectionGet VS Code editor selectionA
Returns the name and path of the file open in VS Code's active editor along with the line range(s) of the current selection(s). Line and character numbers are 1-based.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of overlap or confusion. get_selection has a clearly distinct purpose.
The single tool follows the clear verb_noun pattern (get_selection), and since there are no other tools, there are no inconsistencies.
A single tool is far too few for an editor MCP, which would normally require operations like opening files, editing text, or managing tabs. This feels severely under-scoped.
The tool surface is severely incomplete: it only reads the current selection and provides no way to modify files or interact with the editor in other ways, making most editor workflows impossible.
Related MCP Connectors
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.
Share one project context across ChatGPT, Claude, Telegram and any MCP client.
The OpenRouter MCP server plugs OpenRouter into the AI tools you already use. Once connected, your assistant can pull live OpenRouter data (models, prices, your credits, rankings, and docs) and send quick test messages, all without leaving your editor.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA VS Code extension provides a MCP server that exposes Roslyn language features. It enables tools like find usages, go to definition, quick info, etc.225AGPL 3.0
- AlicenseCqualityFmaintenanceEnables AI agents and assistants like Goose or Claude to interact with VS Code through the Model Context Protocol.7675Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with VS Code's language server protocol features (definitions, references, diagnostics) and debugger (breakpoints, stepping, variable inspection) via an MCP server.4 npm1MIT
- AlicenseNot gradedqualityDmaintenanceProvides VS Code active editor context (open file, cursor position, selection) to MCP-compatible AI tools.11 npm1MIT