Run a local MCP server for your VS Code workspace. Let Claude Desktop and other MCP clients work directly on your code via the Model Context Protocol.
This extension provides a compliant Model Context Protocol (MCP) server for your VS Code workspace, compatible with VS Code, Cursor, Windsurf, and Antigravity via MCP clients.
It acts as the bridge between your local codebase and Claude Desktop: Claude initiates the instructions, and this extension acts as the server to execute development work—reading files, editing code, and running commands—in your workspace.
- Multi-IDE Support: Supports VS Code, Cursor, Windsurf, and Antigravity.
- Claude Desktop Integration: Handles development requests from Claude Desktop, enabling automated programming tasks.
- Compatibility: Supports MCP-compliant clients.
- Zero Configuration: Automatically starts a local MCP server when VS Code launches.
- Toolset:
- 📂 File Operations: Read, write, create, and patch files.
- 💻 Terminal Control: Execute commands, run background tasks, and capture output.
- 🔧 Git Integration: Commit, push, pull, view diffs, and manage branches.
- 🐛 Debugging: Set breakpoints and manage launch configurations.
- 🔍 Code Analysis: Find symbols, references, and definitions.
- Secure Architecture: Binds to localhost only.
- Port Management: Automatic port conflict resolution with background status notifications.
- Cross-Platform: Support for Windows, macOS, and Linux.
- File Caching: Built-in file content caching.
- Search for "GG MCP for VSCode" in the VS Code marketplace and install
- Or click here to install
- Claude Desktop Integration: This extension is compatible with Claude Desktop, enabling:
- Execution of development instructions from Claude
- Automated coding assistance
- Direct read/write access to codebase
- MCPxHub: Recommended for use with MCPxHub plugin
After installation, the MCP server automatically starts. Check the bottom-right status bar:
- 🔄 MCP Server - Server is starting
- 🔌 [Port] - Server is running (e.g.,
🔌 9961) - ❌ MCP Server - Error occurred
Click on the status bar item to see details or restart the server.
When interacting with MCP-compliant AI assistants (like Claude Desktop), capabilities include:
- Viewing open files
- Modifying code
- Performing project tasks
- Developing features
- Executing terminal commands
Capabilities with GG MCP for VSCode and Claude Desktop:
- Codebase analysis
- Feature implementation and bug fixing
- Code refactoring
- Architecture suggestions
- Task implementation
The extension includes a file caching mechanism:
- Reduces file system read operations
- Optimizes file access performance
- Invalidates cache on file modification
- Configurable in extension settings
Find options by searching for "ggMCP" in VS Code settings:
- Port range
- Terminal timeout
- File auto-reload options
- File caching behavior
- MCP: Show Server Status - View current server information
- MCP: Restart Server - Manually restart the MCP server
| Category | Count | Examples |
|---|---|---|
| Editor Tools | 5 | get_open_in_editor_file_text, replace_selected_text, open_file_in_editor |
| File Tools | 9 | get_file_text_by_path, create_new_file_with_text, replace_specific_text |
| Code Analysis | 3 | get_symbols_in_file, find_references, refactor_code_at_location |
| Debug Tools | 4 | toggle_debugger_breakpoint, run_configuration |
| Terminal Tools | 5 | execute_terminal_command, run_command_on_background, get_terminal_info |
| Git Tools | 10 | get_project_vcs_status, commit_changes, switch_branch, get_file_diff |
| Project Tools | 2 | get_project_modules, get_project_dependencies |
| Action Tools | 3 | list_available_actions, execute_action_by_id |
For complete API documentation with examples, see INTERFACE.md.
For technical details and source code, visit our GitHub repository.