mcp-server-image-edit-20250817

motodate/mcp-server-image-edit-20250817

3.1

If you are the rightful owner of mcp-server-image-edit-20250817 and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Image Editor MCP Server provides image editing functionalities using the Pillow library, including brightness adjustment, cropping, and compression.

Image Editor MCP Server

画像編集機能を提供するMCP (Model Context Protocol) サーバーです。 Pillowライブラリを使用して、画像の明るさ調整、トリミング、圧縮の機能を提供します。

機能

1. 明るさ調整 (adjust_brightness)

画像の明るさを調整します。

  • brightness_factor: 0.0（暗い）〜2.0（明るい）の範囲で指定（1.0が元の明るさ）

2. トリミング (crop_image)

画像を指定された比率でトリミングします。

  • width_ratio / height_ratio: 0.0〜1.0の範囲で元画像からの比率を指定
  • position: トリミング位置（center, top-left, top-right, bottom-left, bottom-right）

3. 圧縮 (compress_image)

画像を圧縮して軽量化します。

  • target_size_kb: 目標ファイルサイズ（KB単位）
  • quality: JPEG品質（1〜95）

セットアップ

1. 依存関係のインストール

pipenv install

2. 使用方法

コマンドラインから直接実行
# 画像フォルダを指定してサーバーを起動
pipenv run python run_server.py /path/to/your/images
Claude Desktopでの設定
  1. Claude Desktopの設定ファイル（claude_desktop_config.json）を編集:
{
  "mcpServers": {
    "image-editor-mcp": {
      "command": "pipenv",
      "args": [
        "run",
        "python",
        "/path/to/mcp-server-image-edit-20250817/run_server.py",
        "/path/to/your/images"
      ],
      "env": {
        "PIPENV_PIPFILE": "/path/to/mcp-server-image-edit-20250817/Pipfile"
      }
    }
  }
}

重要な設定ポイント:

  • run_server.pyは絶対パスで指定
  • 画像フォルダも絶対パスで指定
  • PIPENV_PIPFILE環境変数でPipfileの場所を明示的に指定（cwdは不要）

  1. 設定ファイルの場所:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Claude Desktopを再起動

使用例

明るさを調整

画像 "photo.jpg" の明るさを1.5倍にしてください

トリミング

画像 "landscape.png" を中央から50%のサイズでトリミングしてください

圧縮

画像 "large_photo.jpg" を100KB以下に圧縮してください

注意事項

  • 画像フォルダは事前に存在している必要があります
  • 編集した画像は同じフォルダ内に新しいファイルとして保存されます
  • 元の画像ファイルは変更されません
  • 圧縮機能はJPEG形式で保存されます

トラブルシューティング

サーバーが起動しない場合

  1. Pythonのバージョンが3.13以上であることを確認
  2. 依存関係が正しくインストールされているか確認
  3. 指定した画像フォルダが存在するか確認

画像が見つからない場合

  • 画像ファイル名は画像フォルダからの相対パスで指定してください
  • サブフォルダ内の画像もsubfolder/image.jpgのように指定可能

ライセンス

MIT License