wcgw MCP server

Shell and coding agent on mcp clients

What wcgw does

Summarised from the project README; check the repository for the latest details.

Features

• ⚡ Create, Execute, Iterate: Ask claude to keep running compiler checks till all errors are fixed, or ask it to keep checking for the status of a long running command till it's done.
• ⚡ Large file edit: Supports large file incremental edits to avoid token limit issues. Smartly selects when to do small edits or large rewrite based on % of change needed.
• ⚡ Syntax checking on edits: Reports feedback to the LLM if its edits have any syntax errors, so that it can redo it.
• ⚡ Interactive Command Handling: Supports interactive commands using arrow keys, interrupt, and ansi escape sequences.
• ⚡ File protections:
• The AI needs to read a file at least once before it's allowed to edit or rewrite it. This avoids accidental overwrites.

Tools exposed (7)

• Initialize – Reset shell and set up workspace environment
• BashCommand – Execute shell commands with timeout control
• ReadFiles – Read content from one or more files
• WriteIfEmpty – Create new files or write to empty files
• FileEdit – Edit existing files using search/replace blocks
• ReadImage – Read image files for display/processing
• ContextSave – Save project context and files for Knowledge Transfer or saving task checkpoints to be resumed later

Requirements

• Python with uv (runs with uvx/uv)

How to install wcgw MCP in Claude Desktop, Cursor and VS Code

claude mcp add --transport stdio wcgw -- uvx --python 3.12 wcgw@latest

{
  "mcpServers": {
    "wcgw": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "wcgw@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "wcgw": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "wcgw@latest"
      ]
    }
  }
}

{
  "servers": {
    "wcgw": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "wcgw@latest"
      ]
    }
  }
}

Add to config generator – combine it with other servers, or get the Windsurf format.

Listed on Socketlist – add this badge to your README:

Badge markdown[](https://socketlist.pages.dev/s/rusiaaman-wcgw/)

Maintain this project? Get it featured for free during launch →

Compare with context7 →

Related Coding & IDE MCP servers