vscode-mcp-server

Name: vscode-mcp-server
Author: juehang

byjuehang· 1 MCP server

Installs

2.6k

Stars

382

Forks

How to install vscode-mcp-server?

juehang/vscode-mcp-server

$git clone https://github.com/juehang/vscode-mcp-server

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install vscode-mcp-server by running `git clone https://github.com/juehang/vscode-mcp-server`, then use it for the current task and follow its documentation at https://github.com/juehang/vscode-mcp-server.

Files · 1

View on GitHub

README.md

1	# VS Code MCP Server
2
3	A Visual Studio Code extension (available on the [Marketplace](https://marketplace.visualstudio.com/items?itemName=JuehangQin.vscode-mcp-server)) that allows Claude and other MCP clients to code directly in VS Code! Inspired by [Serena](https://github.com/oraios/serena), but using VS Code's built-in capabilities. Perfect for extending existing coding agents like Claude Code with VS Code-specific capabilities (symbol search, document outlines) without duplicating tools they already have. Note that this extension uses the streamable HTTP API, not the SSE API.
4
5	This extension can allow for execution of shell commands. This means that there is a potential security risk, so use with caution, and ensure that you trust the MCP client that you are using and that the port is not exposed to anything. Authentication would help, but as the MCP authentication spec is still in flux, this has not been implemented for now.
6
7	PRs are welcome!
8
9	## Demo Video
10	https://github.com/user-attachments/assets/20b87dfb-fc39-4710-a910-b9481dde1e90
11
12	## Installation
13
14	1. Install the extension from the [Marketplace](https://marketplace.visualstudio.com/items?itemName=JuehangQin.vscode-mcp-server) or clone this repository and run `npm install` and `npm run compile` to build it.
15
16	## Claude Desktop Configuration
17
18	Claude Desktop can be configured to use this extension as an MCP server. To do this, your `claude_desktop_config.json` file should look like this:
19	```
20	{
21	"mcpServers": {
22	"vscode-mcp-server": {
23	"command": "npx",
24	"args": ["mcp-remote@next", "http://localhost:3000/mcp"]
25	}
26
27	}
28	}
29	```
30
31	I also like to use this extension in a Claude project, as it allows me to specify additional instructions for Claude. I find the following prompt to work well:
32	```
33	You are working on an existing codebase, which you can access using your tools. These code tools interact with a VS Code workspace.
34
35	WORKFLOW ESSENTIALS:
36	1. Always start exploration with list_files_code on root directory (.) first
37	2. CRITICAL: Run get_diagnostics_code after EVERY set of code changes before completing tasks
38	3. For small edits (≤10 lines): use replace_lines_code with exact original content
39	4. For large changes, new files, or uncertain content: use create_file_code with overwrite=true
40
41	EXPLORATION STRATEGY:
42	- Start: list_files_code with path='.' (never recursive on root)
43	- Understand structure: read key files like package.json, README, main entry points
44	- Find symbols: use search_symbols_code for functions/classes, get_document_symbols_code for file overviews
45	- Before editing: read_file_code the target file to understand current content
46
47	EDITING BEST PRACTICES:
48	- Small modifications: replace_lines_code (requires exact original content match)
49	- If replace_lines_code fails: read_file_code the target lines, then retry with correct content
50	- Large changes: create_file_code with overwrite=true is more reliable
51	- After any changes: get_diagnostics_code to check for errors
52
53	PLANNING REQUIREMENTS:
54	Before making code modifications, present a comprehensive plan including:
55	- Confidence level (1-10) and reasoning
56	- Specific tools you'll use and why
57	- Files you'll modify and approach (small edits vs complete rewrites)
58	- How you'll verify the changes work (diagnostics, testing, etc.)
59
60	ERROR HANDLING:
61	- Let errors happen naturally - don't add unnecessary try/catch blocks
62	- For tool failures: follow the specific recovery guidance in each tool's description
63	- If uncertain about file content: use read_file_code to verify before making changes
64
65	APPROVAL PROCESS:
66	IMPORTANT: Only run code modification tools after presenting a plan and receiving explicit approval. Each change requires separate approval.
67
68	Do not add tests unless specifically requested. If you believe testing is important, explain why and let the user decide.
69	```
70
71	For context efficiency when exploring codebases, consider adding this to your CLAUDE.md:
72	```
73	## VS Code Symbol Tools for Context Efficiency
74	Use VS Code

6 picks

Type

Install vscode-mcp-server by running `git clone https://github.com/juehang/vscode-mcp-server`, then use it for the current task and follow its documentation at https://github.com/juehang/vscode-mcp-server.

vscode-mcp-server

How to install vscode-mcp-server?

Related

vscode-mcp-server

How to install vscode-mcp-server?

Related