Wcgw MCP Server

WCgw 是一个功能强大的 MCP 服务器，集成了 Shell 和代码编辑工具，允许 AI 在本地机器上执行命令、读写文件、编辑代码等操作。它支持多种开发模式，如架构师模式和代码编写模式，适用于代码开发、问题排查和项目构建等场景。WCgw 提供了任务检查点保存、终端交互、语法检查等功能，确保开发过程的高效与安全。

核心功能

WCgw 提供了多种核心功能，以支持本地开发和调试需求：

• 多任务处理：支持创建、执行和迭代任务，直到所有错误都被修复。
• 大型文件编辑：支持对大文件进行增量编辑，避免因令牌限制导致的问题。
• 语法检查：在文件写入和编辑时进行语法检查，确保代码质量。
• 交互式命令处理：支持带有箭头键、中断和 ANSI 转义序列的交互式命令。
• 文件保护：AI 需要先读取文件才能编辑或重写，避免意外覆盖。
• 模式切换：支持多种模式（如建筑师模式、代码编写者模式），满足不同需求。

安装方法

WCgw 支持通过 Docker 运行和本地安装运行两种方式。

通过 Docker 运行

docker pull amanrusia/wcgw:latest

docker run -it --rm --mount type=bind,src=/Users/username/Desktop,dst=/workspace/Desktop amanrusia/wcgw:latest

本地安装与运行

git clone https://github.com/rusiaaman/wcgw.git

cd wcgw && python3 -m wcgw.main start

配置 MCP 服务器

编辑 claude_desktop_config.json 文件，添加以下内容以启用 WCgw：

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount",
        "type=bind,src=/Users/username/Desktop,dst=/workspace/Desktop",
        "amanrusia/wcgw:latest"
      ]
    }
  }
}

使用方法

安装完成后，可以通过 Claude 应用发送命令，WCgw 会处理这些命令并在本地执行。

基础用法

WCgw 提供了多种命令，例如：

uvx wcgw@latest wcgw_local --limit 0.1

高级用法

WCgw 支持通过 screen 命令访问终端会话：

screen -ls

screen -x 93358.wcgw.235521

此外，还可以通过 VS Code 扩展调用 WCgw，实现更便捷的开发体验。

使用示例

WCgw 可用于多种开发场景，例如：

• 创建一个 Python 项目并运行单元测试。
• 修复代码中的语法错误并重新运行代码。
• 克隆 GitHub 仓库并在本地运行项目。

以下是具体示例：

创建一个Python项目并运行测试。

修复代码中的语法错误。

可选功能

WCgw 还支持与 OpenAI 集成，只需设置以下环境变量：

export OPENAI_API_KEY="your_api_key"
export OPENAI_ORG_ID="your_org_id"

然后运行以下命令：

uvx wcgw@latest wc

适用场景

WCgw 适用于需要在本地环境中进行开发、调试和测试的应用场景，例如：

• 创建 Python 项目并运行单元测试。
• 解决代码问题并修复错误。
• 构建 Web 应用并运行。

WCgw 的多模式支持和交互式命令处理功能，使其成为本地开发和调试的理想工具。

WCgw 通过集成 Shell 和代码编辑功能，为开发者提供了一个强大而灵活的本地开发环境。无论是进行代码编写、调试还是项目构建，WCgw 都能显著提升开发效率和代码质量。