VSC-MCP

This project provides tools that expose Language Server Protocol (LSP) functionality as MCP (Model Context Protocol) tools. It enables AI clients to programmatically analyze and edit code through…

Local serverstdio

What is the VSC-MCP Server?

VSC-MCP is an MCP project maintained in the thomasgazzoni/vsc-mcp repository. The maintainer describes its purpose as “This project provides tools that expose Language Server Protocol (LSP) functionality as MCP (Model Context Protocol) tools. It enables AI clients to programmatically analyze and…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using bun. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares USE_VSCODE_LSP, LOG_DIR, ALLOWED_DIRECTORIES. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
edit_symbolEdits a symbol (function, class, method, etc.) by name and type in a given file using LSP.
read_symbolReads a symbol (function, class, method, etc.) by name and type in a given file using LSP.
read_fileReads the content of a file.
write_fileCreates a new file or overwrites an existing file with the provided content.
search_replace_fileSearches for content in a file and replaces it with new content.
get_errorsFetches code errors and issues for a specific file using the LSP textDocument/diagnostic API.
find_referencesFinds all references to a symbol (function, class, etc.) by name and type in a given file using LSP.

How to install the VSC-MCP Server

{
  "mcpServers": {
    "vsc-mcp": {
      "command": "bun",
      "args": [
        "<vsc_mcp_cloned_dir>/src/index.ts"
      ],
      "env": {
        "USE_VSCODE_LSP": "true",
        "LOG_DIR": "<vsc_mcp_cloned_dir>/logs",
        "ALLOWED_DIRECTORIES": "/path/to/your/project"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
USE_VSCODE_LSPDeclared in the maintainer’s client configuration.Check documentation
LOG_DIRDeclared in the maintainer’s client configuration.Check documentation
ALLOWED_DIRECTORIESDeclared in the maintainer’s client configuration.Check documentation