ggMCP4VSCode

MCP.Pizza Chef: bugstan

ggMCP4VSCode is a Model Context Protocol client for Visual Studio Code that empowers AI assistants to directly interact with the VSCode environment. It automatically starts with VSCode, allowing AI tools to read, modify, analyze code, manage debugging, and execute terminal commands, enhancing developer workflows with seamless AI integration.

Use This MCP client To

Enable AI assistants to read and analyze VSCode project code Allow AI to create and edit files within VSCode Manage breakpoints and run configurations via AI commands Run terminal commands through AI assistants inside VSCode Automatically start MCP client with VSCode launch Facilitate AI-driven code search and navigation Integrate AI tools for debugging assistance in VSCode

README

GG MCP for VSCode

Version License: MIT

Supercharge your AI assistants for VSCode! This extension enables a Model Context Protocol (MCP) server that allows AI assistants to directly interact with your VSCode environment.

MCP Server Status

✨ Key Features

  • Zero Configuration - Automatically starts when VSCode launches
  • AI Assistant Enhancement - Enable AI tools to read, modify, and analyze your code
  • Code Operations - Let AI assistants create, edit files, and search through code
  • Debugging Integration - AI assistants can help manage breakpoints and run configurations
  • Terminal Operations - Allow AI assistants to run terminal commands and get results
  • Git Integration - Check change status, commit history
  • Claude Desktop Compatible - Fully compatible with Claude Desktop, enabling AI-driven automated development

πŸ†• What's New in 1.1.2

  • New Display Name - Renamed to "GG MCP for VSCode" for better clarity and recognition
  • Improved Path Handling - Better cross-platform compatibility and path standardization with the new pathInProject parameter
  • Command Output Capture - AI assistants can now execute commands and get their output
  • Enhanced Terminal Tools - Better terminal text access and command execution
  • File Partial Replacement Interface - Added new replace_specific_text API for replacing specific text in files
    • Provides the ability to replace specific code content locally
    • Supports replacing text within a single line or multiple lines
    • Preserves the original formatting (such as line endings and indents)
  • File Caching Mechanism - Introduced an efficient file caching system to improve performance and reduce redundant file reads

πŸš€ Quick Start

1. Install the Extension

  • Search for "GG MCP for VSCode" in the VS Code marketplace and install
  • Or click here to install

2. Recommended Setup

  • Claude Desktop Integration: This extension is fully compatible with Claude Desktop, allowing you to:
    • Accept and execute development instructions from Claude
    • Enable automated coding assistance through Claude's AI capabilities
    • Let Claude read and modify your codebase directly with proper permissions
  • MCPxHub: For enhanced experience, use with MCPxHub plugin

3. Verify Server Is Running

After installation, the MCP server automatically starts. Check the bottom-right status bar:

  • πŸ”„ MCP Server - Server is starting
  • ⚑ MCP Server - Server is running
  • ❌ MCP Server - Error occurred

Click on the status bar item to see details or restart the server.

4. Use with AI Assistants

When interacting with AI assistants that support the MCP protocol (like Claude Desktop), you can now:

  • Ask the assistant to look at your currently open files
  • Request the assistant to modify code
  • Have the assistant perform project tasks
  • Let Claude automatically develop features based on your requirements
  • Execute terminal commands and get their output

πŸ’» Automated Development with Claude Desktop

With GG MCP for VSCode and Claude Desktop, you can:

  • Instruct Claude to analyze your entire codebase
  • Have Claude automatically implement new features or fix bugs
  • Ask Claude to refactor code while maintaining functionality
  • Let Claude suggest improvements to your code architecture
  • Use natural language to describe coding tasks and let Claude handle the implementation

βš™οΈ Configuration Options

File Caching

The extension now includes an intelligent file caching mechanism:

  • Reduces file system read operations
  • Improves performance for repeated file access
  • Automatically invalidates cache when files are modified
  • Can be configured in extension settings

Find all options by searching for "ggMCP" in VS Code settings:

  • Port range
  • Terminal timeout
  • File auto-reload options
  • File caching behavior

πŸ“„ Commands

  • MCP: Show Server Status - View current server information
  • MCP: Restart Server - Manually restart the MCP server

πŸ”— Links

πŸ“ License

MIT


Detailed Documentation

For more technical details and API documentation, please visit our GitHub repository.

ggMCP4VSCode FAQ

How does ggMCP4VSCode start within VSCode?
It automatically launches when VSCode starts, requiring zero configuration.
Can AI assistants modify my code using ggMCP4VSCode?
Yes, AI assistants can create, edit, and analyze code directly in your VSCode environment.
Does ggMCP4VSCode support debugging features?
Yes, it allows AI assistants to manage breakpoints and run configurations for debugging.
Can AI assistants run terminal commands in VSCode with this client?
Yes, AI can execute terminal commands and receive responses within VSCode.
Is any special setup required to use ggMCP4VSCode?
No special setup is needed; it works out-of-the-box with VSCode.
Which AI models are compatible with ggMCP4VSCode?
It supports any MCP-compatible AI models, including OpenAI, Anthropic Claude, and Google Gemini.
How does ggMCP4VSCode enhance AI assistant capabilities?
By exposing VSCode environment context and operations, it enables AI to perform complex code and environment interactions.
Is ggMCP4VSCode open source?
Yes, it is available under the MIT license on GitHub.