Wcgw

🚀 Shell 使用说明

本项目提供了 Shell 工具的使用说明，涵盖安装启动、配置服务器、使用案例及可选功能等内容，帮助用户快速上手并充分利用其各项特性。

🚀 快速开始

本工具支持通过 Docker 运行和本地安装运行两种方式，你可以根据自己的需求进行选择。

🐳 通过 Docker 运行

1. 拉取官方镜像：

docker pull amanrusia/wcgw:latest

2. 启动容器并挂载工作目录（例如将宿主机的 /Users/username/Desktop 挂载到容器内的 /workspace/Desktop）：

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

💻 本地安装与运行

1. 克隆仓库：

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

2. 进入目录并启动：

cd wcgw && python3 -m wcgw.main start

📦 安装指南

配置 MCP 服务器

修改配置文件

编辑 claude_desktop_config.json 添加以下内容：

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

💻 使用示例

基础用法

示例

高级用法

屏幕终端访问

1. 列出所有 screen 会话：

screen -ls

2. 连接特定的 wcgw 会话（例如 93358.wcgw.235521）：

screen -x 93358.wcgw.235521

使用 VS Code 扩展

安装并使用 wcgw VS Code 扩件，通过快捷键调用 Claude。

🔧 技术细节

可选功能

OpenAI 集成

设置环境变量：

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

运行命令：

uvx wcgw@latest wc