GG MCP for VSCode enables you to run a local Model Context Protocol (MCP) server directly within your VS Code workspace. This extension acts as a high-performance bridge between your local codebase and AI assistants like Claude Desktop, Cursor, and Windsurf. By establishing a compliant MCP connection, it allows AI agents to perform complex development tasks—such as reading files, editing code, and executing terminal commands—securely within your local environment.

Key Features

• Multi-IDE Compatibility: Full support for VS Code, Cursor, Windsurf, and Antigravity via MCP clients.
• Claude Desktop Integration: Seamlessly handles development requests from Claude, enabling autonomous programming and codebase analysis.
• Zero Configuration: Automatically initializes a local MCP server upon launching VS Code.
• Comprehensive Toolset:
  • 📂 File Operations: Advanced capabilities to read, write, create, and patch files.
  • 💻 Terminal Control: Execute commands, manage background tasks, and capture real-time output.
  • 🔧 Git Integration: Streamlined workflow for commits, pushes, pulls, diff viewing, and branch management.
  • 🐛 Debugging: Manage breakpoints and launch configurations programmatically.
  • 🔍 Code Analysis: Deep inspection of symbols, references, and definitions.
• Secure Architecture: The server binds exclusively to localhost to ensure your data remains private.
• Intelligent Port Management: Built-in automatic port conflict resolution and status monitoring.
• Cross-Platform Support: Optimized for Windows, macOS, and Linux environments.
• Performance Optimization: Features internal file caching to reduce disk I/O and improve response latency.

Quick Start

1. Install the Extension

• Search for GG MCP for VSCode in the VS Code Marketplace and click install.
• Alternatively, use the direct link: Install via VS Code.

2. Recommended Setup

To get the most out of the extension, we recommend the following integrations:

• Claude Desktop: Connect your codebase to Claude for automated coding assistance and direct read/write access.
• MCPxHub: Enhance your experience using the MCPxHub plugin for advanced server management.

3. Verify Server Status

Once installed, the MCP server starts automatically. Monitor the status via the VS Code status bar in the bottom-right corner:

• 🔄 MCP Server: The server is currently initializing.
• 🔌 [Port]: The server is active and listening (e.g., 🔌 9961).
• ❌ MCP Server: An error occurred during startup.

You can click the status bar item at any time to view detailed logs or manually restart the server.

4. Using with AI Assistants

Once active, your MCP-compliant AI assistant can:

• Analyze the entire project structure.
• Read and modify specific source files.
• Execute terminal commands to run tests or builds.
• Perform complex refactoring tasks across multiple files.

Automated Development Capabilities

When paired with Claude Desktop, GG MCP for VSCode empowers the AI to handle:

• Feature Implementation: Write and integrate new features from a natural language prompt.
• Bug Fixing: Identify issues and apply patches directly to the source.
• Refactoring: Execute large-scale code improvements with awareness of project symbols.
• Architecture Suggestions: Get high-level design advice based on your actual code structure.

Configuration Options

Fine-tune the extension behavior by searching for ggMCP in your VS Code settings:

• Port Range: Define the range of ports the server should attempt to bind to.
• Terminal Timeout: Set the maximum duration for executed terminal commands.
• File Caching: Enable or disable the caching mechanism to balance performance and memory usage.
• Auto-Reload: Configure how the server responds to file modifications in the workspace.

Extension Commands

Access these commands via the Command Palette (Ctrl+Shift+P or Cmd+Shift+P):

• MCP: Show Server Status: Displays current connection details and active tools.
• MCP: Restart Server: Manually cycles the MCP server instance.

Available Tools (44 total)

Resource Links

• Documentation: For complete API details and examples, see INTERFACE.md.
• Source Code: Visit the GitHub Repository.
• Issue Tracking: Report bugs or request features on the GitHub Issues page.
• Protocol Specs: Learn more about the Model Context Protocol Specification.