MCP WCGW
Shell and file edit capabilities tightly coupled to provide a powerful coding experience. You can work with different modes: architect and code-writer for separate plan and implementation phase. You can get it to invoke any cli command, e.g., compili
What is MCP WCGW?
MCP WCGW is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to shell and file edit capabilities tightly coupled to provide a powerful coding experience. you can work with different modes: architect and code-writer for separate plan and implementation phase. you c...
Shell and file edit capabilities tightly coupled to provide a powerful coding experience. You can work with different modes: architect and code-writer for separate plan and implementation phase. You can get it to invoke any cli command, e.g., compili
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Shell and file edit capabilities tightly coupled to provide
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-wcgwConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP WCGW
WCGW (What Could Go Wrong) is a powerful MCP server that tightly couples shell execution and file editing capabilities to give AI assistants a complete coding environment. It connects to your local machine's shell, filesystem, and running processes, enabling AI models to compile code, run tests, edit files, and execute any CLI command. Developers use it to delegate multi-step coding tasks — including architecture planning and implementation — to AI assistants like Claude without context-switching.
Prerequisites
- Python 3.12 or higher installed on your system
- uv package manager installed (brew install uv on macOS, or curl -LsSf https://astral.sh/uv/install.sh | sh on Linux)
- Claude Desktop or another MCP-compatible client
- A Unix-like environment (macOS, Linux, or Windows with WSL)
Install uv package manager
WCGW is distributed as a Python package and runs via uvx, which is part of the uv toolchain. Install uv using Homebrew on macOS or the official install script on Linux.
brew install uvOpen Claude Desktop configuration
Locate and open your Claude Desktop configuration file. On macOS this is at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows with WSL, it is at %APPDATA%\Claude\claude_desktop_config.json.
Add WCGW to your MCP server config (macOS/Linux)
Add the wcgw server entry to the mcpServers object in your Claude Desktop config. The uvx command will automatically fetch and run the latest version of wcgw using Python 3.12.
{
"mcpServers": {
"wcgw": {
"command": "uvx",
"args": ["--python", "3.12", "wcgw@latest"]
}
}
}Add WCGW to your MCP server config (Windows WSL)
On Windows, route the command through WSL so that the Python environment and shell tools are available. Replace the command with wsl.exe and pass uvx as an argument.
{
"mcpServers": {
"wcgw": {
"command": "wsl.exe",
"args": ["uvx", "--python", "3.12", "wcgw@latest"]
}
}
}Restart Claude Desktop
Save the configuration file and fully quit and relaunch Claude Desktop. WCGW will be automatically downloaded and started when Claude Desktop connects to it.
Initialize a workspace session
Start a conversation in Claude Desktop and ask it to initialize WCGW with a working directory. You can optionally specify architect mode (read-only analysis) or code-writer mode (with path restrictions) to control what the AI can modify.
MCP WCGW Examples
Client configuration
Standard Claude Desktop configuration for WCGW using uvx on macOS/Linux. For Windows WSL users, replace command with wsl.exe and prepend uvx to args.
{
"mcpServers": {
"wcgw": {
"command": "uvx",
"args": ["--python", "3.12", "wcgw@latest"]
}
}
}Prompts to try
Example prompts to use with WCGW in Claude Desktop for shell and file editing tasks.
- "Initialize a workspace in ~/my-project and run the test suite"
- "Read the files in src/ and identify any syntax errors, then fix them"
- "Run in architect mode and create a plan for refactoring the authentication module"
- "Run in code-writer mode restricted to tests/** and update the unit tests for the login function"
- "Clone the git repo at https://github.com/example/repo, install dependencies, and run npm start"Troubleshooting MCP WCGW
uvx command not found after installing uv
Restart your terminal or run `source ~/.bashrc` (or `~/.zshrc`) to reload PATH. Verify with `which uvx`. If still missing, reinstall uv with `curl -LsSf https://astral.sh/uv/install.sh | sh`.
Shell commands fail or Claude cannot find executables
WCGW inherits the environment of the process that launches it. Ensure your PATH is correctly set in your shell profile (~/.bashrc or ~/.zshrc). On macOS, Claude Desktop may have a restricted PATH — you can force a specific shell with the --shell flag: `"args": ["--python", "3.12", "wcgw@latest", "--shell", "/bin/bash"]`.
On Windows, commands run but file paths look wrong
Make sure you are using the WSL configuration variant with wsl.exe as the command. WCGW uses Unix-style paths internally, so working directories must be expressed as /mnt/c/... paths within WSL rather than Windows C:\ paths.
Frequently Asked Questions about MCP WCGW
What is MCP WCGW?
MCP WCGW is a Model Context Protocol (MCP) server that shell and file edit capabilities tightly coupled to provide a powerful coding experience. you can work with different modes: architect and code-writer for separate plan and implementation phase. you can get it to invoke any cli command, e.g., compili It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP WCGW?
Follow the installation instructions on the MCP WCGW GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP WCGW?
MCP WCGW works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP WCGW free to use?
Yes, MCP WCGW is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
MCP WCGW Alternatives — Similar Coding Agents Servers
Looking for alternatives to MCP WCGW? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP WCGW in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP WCGW?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.