Posted in Uncategorized

Image2pixel MCP / CLI 使用指南

   Published Date: March 5, 2026

Image2pixel MCP / CLI 使用指南

Image2pixel 是一款可將圖片轉換為像素畫風格的工具，在 Steam 上以 App 形式提供；同時也提供 CLI（命令列介面） 與 MCP（Model Context Protocol），方便在終端、腳本或 AI 助手（如 Cursor）中直接調用。本文介紹如何配置與使用這兩種方式。

一、CLI：命令列介面

腳本位置

CLI 腳本位於 Image2pixel App 的資源目錄內（以 Steam 安裝為例）：

…/Image2pixel.app/Contents/Resources/app.asar.unpacked/src/interface/cli/bin.js

macOS 常見完整路徑示例：

/Users/<你的用戶名>/Library/Application Support/Steam/steamapps/common/Image2pixel/Image2pixel.app/Contents/Resources/app.asar.unpacked/src/interface/cli/bin.js

需已安裝 Node.js，並使用 node 執行該腳本。

建議：設定全域別名

在 ~/.zshrc（或 ~/.bashrc）中加入：

alias pixelit='node "/Users/<你的用戶名>/Library/Application Support/Steam/steamapps/common/Image2pixel/Image2pixel.app/Contents/Resources/app.asar.unpacked/src/interface/cli/bin.js"'

將 <你的用戶名> 替換為實際用戶名，存檔後執行：

source ~/.zshrc

之後即可在任意目錄使用 pixelit 指令。

常用指令

| 指令 | 說明 |
|——|——|
| pixelit analyze <input> | 分析圖片特徵 |
| pixelit convert <input> -o <output> | 單張轉換為像素畫 |
| pixelit batch <inputDir> -o <outputDir> | 批次轉換整個目錄 |
| pixelit algorithm-list | 列出可用演算法 |

常用參數（convert / batch）

  • --algo <名稱>：指定演算法（如 slic、standard 等，可先執行 algorithm-list 查看）。
  • --block-size <數字>：區塊大小，影響像素化程度。

範例

單張轉換（使用 SLIC 演算法、區塊大小 10）：

pixelit convert input.png -o output.png --algo slic --block-size 10

批次轉換資料夾：

pixelit batch ./input_folder -o ./output_folder --algo standard

二、MCP：與 AI 助手整合

Image2pixel 提供 MCP Server，讓支援 MCP 的 AI 環境（例如 Cursor IDE）能直接調用「分析、轉換、批次」等能力，而無需手動輸入 CLI 指令。

MCP 配置檔位置

MCP server 腳本通常位於 App 同目錄下，例如：

…/app.asar.unpacked/mcp-server.js

在 Cursor 中啟用

在 Cursor 的 MCP 設定檔（例如 ~/.cursor/mcp.json）的 mcpServers 中加入：

"image2pixel": {
  "command": "node",
  "args": [
    "/Users/<你的用戶名>/Library/Application Support/Steam/steamapps/common/Image2pixel/Image2pixel.app/Contents/Resources/app.asar.unpacked/mcp-server.js"
  ]
}

儲存後重新載入 MCP 或重啟 Cursor，即可在對話中透過自然語言請助手代為執行轉換（例如：「把某張圖轉成像素畫」）。

注意：若使用 Cursor 的雲端 CLI 或遠端環境，該環境可能無法連到你本機的 MCP server；此時仍可依賴 CLI，由助手根據你的描述組出對應的 pixelit 指令供你在本機執行。

三、自然語言 + CLI 的用法

即使不啟用 MCP，只要本機已設定好 pixelit 別名，你可以在對話中這樣描述需求：

  • 「把 /path/to/photo.png 轉成像素畫，輸出到 /path/to/photo.pixel.png，用預設或智能推薦的演算法。」
  • 「幫我把 ~/Pictures/raw 底下的圖都用 image2pixel 批次轉成像素畫到 ~/Pictures/pixelated。」

助手會將需求轉成對應的 pixelit convert 或 pixelit batch 指令；你只要在終端執行即可。

四、小結

| 方式 | 適用場景 |
|——|———-|
| CLI + 別名 | 終端手動執行、腳本自動化、任何可跑 shell 的環境 |
| MCP | Cursor 等支援 MCP 的 IDE，用自然語言請 AI 直接調用 |
| 自然語言描述 + CLI | 在對話中說明需求，由 AI 產出 pixelit 指令，你在本機執行 |

先完成 pixelit 別名與（可選）MCP 配置，之後無論是手動下指令還是交給 AI，都能更順暢地使用 Image2pixel 的像素畫轉換能力。

Author: PixelBear