N2NS Lab
← Open Source Projects
Public open-source project

GG MCP for VS Code

MCP access to VS Code files, terminals, Git, and editor actions inside Workspace Trust boundaries.

VS Code, Cursor, Windsurf, and Antigravity users connecting MCP clients to local workspace tools.

bugstan.gg-mcp-for-vscodev1.3.0MITExtensionsVS CodeMCPAI Agent
View on GitHub

Links

Tool reference
Build and release notes
Open VSX

Requirements

  • VS Code-compatible editor with extension API >= 1.93.0.
  • Workspace Trust enabled.
  • An MCP client such as Claude Desktop or a compatible bridge such as MCPxHub.

Install

text
Install GG MCP for VSCode from the VS Code marketplace or Open VSX.
text
Or use the extension URI: vscode:extension/bugstan.gg-mcp-for-vscode.

Configure

text
The local MCP server starts automatically when VS Code launches.
text
Default port range is 9960-9990.
text
Search for ggMCP in VS Code settings to adjust port range, terminal timeout, file reload behavior, logging, and output limits.

Overview

  • VS Code extension with a local MCP server for the active workspace.
  • MCP clients can read files, edit code, run terminal commands, inspect Git, and use editor actions.
  • Binds locally and shows server status in the status bar.

Common Uses

  • Connect Claude Desktop or another MCP client to a VS Code workspace.
  • Route file, terminal, Git, and debug actions through the editor boundary.
  • Pair with MCPxHub when a client needs bridge support.

Documentation

  • README covers installation, status bar states, and common settings.
  • Interface reference lists the editor actions available to MCP clients.
  • Deployment notes explain packaging for users building from source.
  • Review Workspace Trust before enabling terminal or file-edit tools.

Next Steps

  • Install the extension and verify the status bar shows a running port.
  • Use MCPxHub or another MCP client to connect to the local server.
  • Review workspace trust and command permissions before exposing tools.

Tools / Commands

  • MCP: Show Server Status
  • MCP: Restart Server

Resources / Settings

  • Editor tools: open-file text, selected text replacement, open file in editor.
  • File tools: read, write, create, and targeted text replacement.
  • Code analysis tools: symbols, references, and refactoring helpers.
  • Debug tools: breakpoints and launch configurations.
  • Terminal tools: command execution, background tasks, terminal info.
  • Git tools: status, commit, branch switch, pull, push, diffs.
  • Project tools: modules and dependencies.
  • Action tools: list and execute available IDE actions.

FAQ

Frequently asked questions and troubleshooting guides.

It adheres to the editor's Workspace Trust boundary. Commands are executed through the editor's terminal context, and sensitive operations require explicit permissions or user confirmations.
This extension targets VS Code-compatible editors. For JetBrains IDEs, use the JetBrains MCP Server plugin with MCPxHub.