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