Waferlock MCP CLI (Public)

這個專案提供一個獨立的 CLI，透過 Waferlock Robot MCP 在 Heroku 上的公開 REST API，將資料橋接到支援 Model Context Protocol (MCP) 的客戶端（例如 ChatGPT Desktop）。使用者只需要 API URL 與 Token，即可在本地啟動 stdio 版 MCP 伺服器，不需暴露 AWS 憑證。

安裝與使用

1. 取得程式碼

git clone https://github.com/jasonlcs/waferlock-robot-mcp-public.git
cd waferlock-robot-mcp-public

2. 編譯

npm install
npm run build

3. 直接執行 (本地調試)

node dist/cli.js \
  --api-url https://waferlock-robot-mcp-1177c207c107.herokuapp.com \
  --api-token <你的 API Token> \
  --mcp-token <選填：要求 MCP 客戶端提供的 Token>

• --server-name：覆寫 MCP server 名稱
• --server-version：覆寫 MCP server 版本
• --mcp-token：若指定，MCP 客戶端必須提供同樣的 Token（透過環境變數或連線設定）

4. 透過 npx 執行 (Git 來源)

建立 tag 後（例如 git tag v1.0.0 && git push origin v1.0.0），即可提供使用者以下指令：

npx --yes github:jasonlcs/waferlock-robot-mcp-public#v1.0.0 \
  --api-url https://waferlock-robot-mcp-1177c207c107.herokuapp.com \
  --api-token <你的 API Token> \
  --mcp-token <選填>

5. ChatGPT Desktop 設定範例

{
  "mcpServers": {
    "waferlock-robot": {
      "command": "npx",
      "args": [
        "--yes",
        "github:jasonlcs/waferlock-robot-mcp-public#v1.0.0",
        "--api-url", "https://waferlock-robot-mcp-1177c207c107.herokuapp.com",
        "--api-token", "<你的 API Token>",
        "--mcp-token", "<選填>"
      ]
    }
  }
}

將 jasonlcs、waferlock-robot-mcp-1177c207c107、<你的 API Token> 改成實際值即可使用。

專案結構

waferlock-robot-mcp-public/
├── package.json
├── tsconfig.json
├── README.md
└── src
    ├── cli.ts
    └── services
        ├── manualApiProvider.ts
        ├── manualProvider.ts
        └── mcpService.ts

開發注意事項

• 需要 Node.js 18+（提供原生 fetch）。
• CLI 會優先讀取命令列參數（--api-url、--api-token 等），若未提供則回退至環境變數 API_URL、API_TOKEN、MCP_TOKEN。
• 內建 dotenv，會載入 .env（選用）。
• 專案使用 TypeScript；若想讓使用者省去編譯步驟，可在 repo 中同步 dist/，或加上 npm prepare 腳本在安裝時自動編譯。

後續步驟

1. npm run build 確認 dist/ 生成。必要時 chmod +x dist/cli.js。
2. git add . && git commit -m "Initial public CLI"，再 git push -u origin main。
3. 建立版本 tag（例：git tag v1.0.0 && git push origin v1.0.0）。
4. 在主專案或文件提到此 CLI，指引用法（npx github:... 或 node dist/cli.js ...）。

授權

ISC License