Shell and Coding agent for Claude and other MCP clients

@rusiaaman

代码仓库

基本信息

分类

AI 与智能体

许可证

Apache-2.0

传输方式

stdio

作者

rusiaaman

关于 Shell and Coding agent for Claude and other MCP clients

Shell and coding agent on mcp clients

#shell #agent #terminal #mcp #openai #claude #ai-agent #llm #chatgpt #anthropic #llm-agent#custom-gpt#claude-desktop#llm-code#ai-coding #mcp-server

Shell and Coding agent for Claude and other MCP clients 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Shell and Coding agent for Claude and other MCP clients 工具

Reset shell and set up workspace environment

Execute shell commands with timeout control

Read content from one or more files

Create new files or write to empty files

Edit existing files using search/replace blocks

Read image files for display/processing

Save project context and files for Knowledge Transfer or saving task checkpoints to be resumed later

概览

What is Shell and Coding agent for Claude and other mcp clients?

Shell and Coding agent for Claude and other mcp clients (wcgw) is an MCP server that provides tightly integrated shell and code editing tools, enabling chat applications to code, build, and run on your local machine. It offers a fully interactive shell experience that both you and the AI agent can control, including sending keystrokes.

How to use Shell and Coding agent for Claude and other mcp clients?

Install uv (e.g., brew install uv on macOS), then add the server to your claude_desktop_config.json with the command uvx and args ["--python", "3.12", "wcgw@latest"]. Optionally force a specific shell with --shell. On Windows, use wsl.exe as the command. After configuration, restart Claude and look for the rocket icon. You can then ask Claude to execute shell commands, read/write files, run code, or use built-in modes (architect, code-writer, wcgw).

Key features of Shell and Coding agent for Claude and other mcp clients

Create, execute, and iterate with automatic retries
Large file incremental edits to avoid token limits
Syntax checking on edits with feedback to the AI
Interactive command handling with arrow keys and interrupts
File protections: read-before-edit, chunked large files
Task checkpointing with ContextSave tool and resume support

Use cases of Shell and Coding agent for Claude and other mcp clients

Ask Claude to run compiler checks until all errors are fixed
Iterate on code changes with large file edits and syntax validation
Save task context for later resume or knowledge transfer between AIs
Use architect mode to plan before editing, or code-writer mode to restrict edits to specific paths
Attach to the AI’s terminal via screen to enter passwords or investigate commands

常见问题

What runtime dependencies are required?

Python 3.12, `uv` (package installer), and optionally `screen` for terminal attachment. On Windows, WSL is required.

How does the terminal attachment work?

If `screen` is installed, wcgw runs in a screen session. You can list sessions with `screen -ls` and attach with `screen -x` to safely interact with the AI’s terminal.

What modes are available and how do they differ?

Three modes: **architect** (read-only commands), **code-writer** (edits/writes allowed only on specified path globs), and **wcgw** (default, unrestricted). Invoke by saying “Run in [mode] mode”.

What are the known risks or limitations?

The server provides unfiltered shell and file access. It does not restrict the LLM from executing arbitrary commands or making unintended changes. Use only if you fully understand and accept the risks.

Does the server support authentication or encryption?

The README does not mention any authentication or encryption mechanisms. Communication relies on the MCP transport (stdio by default).

AI 与智能体分类下的更多 MCP 服务器

Pocket Network Agentic Marketplace: Pay-per-Call APIs

Pocket Network Foundation

MCP server for the Pocket Network agentic marketplace: search our catalog of data services and utilities and call them, paying per request in USDC on Base with x402. No account or API key. Search and describe are free; p

strac-mcp-dlp

strac-io

Detect and redact PII, PHI, PCI and secrets — SSNs, credit cards, passports, API keys and cloud credentials — in text and in local files, using the Strac DLP API. Five tools: redact_text, detect_sensitive_data, detect_fi

Legion MCP

faulkj

MCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.

WordPress MCP Server

miniOrange

miniOrange WordPress MCP Server turns a WordPress site into a Model Context Protocol server, so AI clients like Claude, ChatGPT, Cursor, Gemini and Windsurf can read and edit the site through chat instead of the admin da

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.