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