MCP Image Extractor

MCP Image Extractor

用于提取图像并将其转换为 base64 以供大模型分析的 MCP 服务。

此 MCP 服务为 AI 助手提供以下工具：

• 从本地文件中提取图像
• 从 URL 中提取图像
• 处理 base64 编码的图像

在 Cursor 中的效果：

适用场景：

• 分析 playwright 测试结果：截图

安装

推荐：在 mcp.json 中使用 npx（最简单）

推荐的安装方式是在 .cursor/mcp.json 文件中直接使用 npx：

{
  "mcpServers": {
    "image-extractor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image-extractor"
      ]
    }
  }
}

这种方式：

• 自动安装最新版本
• 无需全局安装
• 可在不同环境中可靠运行

其他方式：本地路径安装

如果你更倾向于本地安装此软件包，可以克隆代码仓库并指向构建后的文件：

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

手动安装

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

这样便可全局使用 mcp-image-extractor 命令。

然后在 .cursor/mcp.json 中进行配置：

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

Cursor 用户故障排除：如果看到“Failed to create client”错误，请尝试上述本地路径安装方式，或确认使用了可执行文件的正确路径。

可用工具

extract_image_from_file

从本地文件中提取图像并将其转换为 base64。

参数：

• file_path（必填）：本地图像文件的路径

注意： 为了限制 base64 输出的大小并优化上下文窗口的使用，所有图像都会自动调整为适合大模型分析的最佳尺寸（最大 512x512）。

extract_image_from_url

从 URL 中提取图像并将其转换为 base64。

参数：

• url（必填）：要提取的图像的 URL

注意： 为了限制 base64 输出的大小并优化上下文窗口的使用，所有图像都会自动调整为适合大模型分析的最佳尺寸（最大 512x512）。

extract_image_from_base64

处理 base64 编码的图像，以供大模型分析。

参数：

• base64（必填）：Base64 编码的图像数据
• mime_type（可选，默认值："image/png"）：图像的 MIME 类型

注意： 为了限制 base64 输出的大小并优化上下文窗口的使用，所有图像都会自动调整为适合大模型分析的最佳尺寸（最大 512x512）。

使用示例

以下是如何通过 Claude 使用这些工具的示例：

Please extract the image from this local file: images/photo.jpg

Claude 会自动使用 extract_image_from_file 工具加载并分析图像内容。

Please extract the image from this URL: https://example.com/image.jpg

Claude 会自动使用 extract_image_from_url 工具获取并分析图像内容。

Docker

使用 Docker 构建并运行：

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

许可证

MIT