Image Extractor

🚀 圖像提取器 MCP 服務器

本項目為 AI 助手提供工具，可從本地文件、URL 和 base64 編碼的圖像中提取和轉換圖像，以供 LLM 進行分析。

✨ 主要特性

• 支持從本地文件中提取圖像。
• 能夠從 URL 中提取圖像。
• 可處理 base64 編碼的圖像。

🚀 快速開始

適用場景

• 分析 Playwright 測試結果中的截圖。

📦 安裝指南

使用 .cursor/mcp.json 文件進行配置

在本地開發或特定項目中，您可以在項目根目錄下添加一個 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "image-extractor": {
      "command": "node",
      "args": ["/full/path/to/mcp-image-extractor/dist/index.js"],
      "disabled": false
    }
  }
}

或者，如果您已通過 npm link 安裝：

{
  "mcpServers": {
    "image-extractor": {
      "command": "mcp-image-extractor",
      "disabled": false
    }
  }
}

⚠️ 重要提示（適用於 Cursor 用戶）

如果遇到“Failed to create client”的錯誤，請嘗試以下替代方案：

方案 1：使用直接從 GitHub 安裝

git clone https://github.com/ifmelate/mcp-image-extractor.git
cd mcp-image-extractor
npm install
npm run build
npm link

然後在 .cursor/mcp.json 中配置：

{
  "mcpServers": {
    "image-extractor": {
      "command": "mcp-image-extractor",
      "disabled": false
    }
  }
}

方案 2：克隆並本地運行

git clone https://github.com/ifmelate/mcp-image-extractor.git
cd mcp-image-extractor
npm install
npm run build

然後在 .cursor/mcp.json 中配置：

{
  "mcpServers": {
    "image-extractor": {
      "command": "node",
      "args": ["/full/path/to/mcp-image-extractor/dist/index.js"],
      "disabled": false
    }
  }
}

💻 使用示例

可用工具

extract_image_from_file

從本地文件中提取圖像並將其轉換為 base64 編碼。 參數：

• file_path（必需）：本地圖像文件的路徑

注意：所有圖像都會自動以 base64 編碼格式輸出，適合在需要編碼的環境中使用。

extract_image_from_url

從 URL 中提取圖像並將其轉換為 base64 編碼。 參數：

• url（必需）：包含要提取圖像的 URL 地址

注意：請確保您提供的 URL 是合法且可訪問的。如果 URL 無效或無法訪問，可能會導致錯誤。

extract_image_from_base64

將 base64 編碼的字符串解碼為圖像文件。 參數：

• base64_string（必需）：要轉換的 base64 編碼字符串

注意：此工具僅接受有效的 base64 字符串。如果輸入無效，可能會導致錯誤。

📦 Docker 配置

使用 Docker 構建和運行：

docker build -t mcp-image-extractor .
docker run -p 8000:8000 mcp-image-extractor

訪問 http://localhost:8000 查看服務狀態。

📄 許可證

本項目採用 MIT 許可證。