Image Extractor

🚀 画像抽出器 MCP サーバー

AI アシスタントに、ローカルファイル、URL、および base64 エンコードされた画像から画像を抽出し、LLM 分析用に変換するツールを提供します。

この MCP サーバーが提供する機能は以下の通りです。

• ローカルファイルから画像を抽出する
• URL から画像を抽出する
• base64 エンコードされた画像を処理する

Cursor での表示例は以下の通りです。

適用シーン：

• 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