MCP サーバー - 画像

URL、ローカルファイルパス、NumPy配列から画像を取得・処理するためのツールを提供する、モデルコンテキストプロトコル（MCP）サーバーです。このサーバーには、画像をMIMEタイプとともにBase64エンコードされた文字列として返すfetch_imagesというツールが含まれています。

私たちをサポートしてください

このプロジェクトが役に立ったと感じ、今後のプロジェクトを応援したいと思われた方は、ぜひコーヒーをご馳走ください！皆様のご支援は、革新的なAIソリューションの構築を支えていきます。

あなたの貢献は、インテリジェントでユーザーフレンドリーなアプリケーションを作成するという私たちの情熱を高めるのに大いに役立ちます。

特徴

URL（http/https）から画像を取得する
ローカルファイルパスから画像を読み込む
大きなローカル画像に特化した処理
大きな画像（1MB以上）の自動画像圧縮
複数の画像の並列処理
異なるファイル拡張子に対する適切なMIMEタイプのマッピング
包括的なエラー処理とログ記録

前提条件

Python 3.10以上
uv パッケージマネージャー (推奨)

インストール

このリポジトリをクローンする
uv を使用して仮想環境を作成し、アクティブ化します。

uv venv
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate

uv を使用して依存関係をインストールします。

uv pip install -r requirements.txt

サーバーの実行

MCP サーバーを実行するには 2 つの方法があります。

1. 直接法

MCP サーバーを直接起動するには:

uv run python mcp_image.py

2. ウィンドサーフィン/カーソルの設定

ウィンドサーフィン

この MCP サーバーを Windsurf に追加するには:

~/.codeium/windsurf/mcp_config.json にある設定ファイルを編集します。
次の構成を追加します。

{
  "mcpServers": {
    "image": {
      "command": "uv",
        "args": ["--directory", "/path/to/mcp-image", "run", "mcp_image.py"]
    }
  }
}

カーソル

この MCP サーバーをカーソルに追加するには:

カーソルを開いて設定に移動します（ナビゲーションバー→カーソル設定）
機能→ MCPサーバーへ移動
+ 新しいMCPサーバーを追加をクリックします
次の構成を入力します。

{
  "mcpServers": {
    "image": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-image", "run", "mcp_image.py"]
    }
  }
}

利用可能なツール

サーバーは次のツールを提供します。

fetch_images : URL またはローカルファイルパスから画像を取得して処理します。パラメータ: image_sources: 画像への URL またはファイルパスのリスト。戻り値: base64 エンコードと MIME タイプを持つ処理済み画像のリスト。

使用例

次のようなコマンドを使用できるようになりました。

「これらの画像を取得: [URL またはファイルパスのリスト]」
「このローカルイメージを読み込んで処理します: [file_path]」

例

# URL-only test
[
  "https://upload.wikimedia.org/wikipedia/commons/thumb/7/70/Chocolate_%28blue_background%29.jpg/400px-Chocolate_%28blue_background%29.jpg",
  "https://imgs.search.brave.com/Sz7BdlhBoOmU4wZjnUkvgestdwmzOzrfc3GsiMr27Ik/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9pbWdj/ZG4uc3RhYmxlZGlm/ZnVzaW9ud2ViLmNv/bS8yMDI0LzEwLzE4/LzJmOTY3NTViLTM0/YmQtNDczNi1iNDRh/LWJlMTVmNGM5MDBm/My5qcGc",
  "https://shigacare.fukushi.shiga.jp/mumeixxx/img/main.png"
]

# Mixed URL and local file test
[
  "https://upload.wikimedia.org/wikipedia/commons/thumb/7/70/Chocolate_%28blue_background%29.jpg/400px-Chocolate_%28blue_background%29.jpg",
  "C:\\Users\\username\\Pictures\\image1.jpg",
  "https://imgs.search.brave.com/Sz7BdlhBoOmU4wZjnUkvgestdwmzOzrfc3GsiMr27Ik/rs:fit:860:0:0:0/g:ce/aHR0cHM6Ly9pbWdj/ZG4uc3RhYmxlZGlm/ZnVzaW9ud2ViLmNv/bS8yMDI0LzEwLzE4/LzJmOTY3NTViLTM0/YmQtNDczNi1iNDRh/LWJlMTVmNGM5MDBm/My5qcGc",
  "C:\\Users\\username\\Pictures\\image2.jpg"
]

デバッグ

問題が発生した場合:

すべての依存関係が正しくインストールされていることを確認する
サーバーが実行中で接続を待機していることを確認します
ローカル画像の読み込みに関する問題については、ファイルパスが正しくアクセス可能であることを確認してください。
「サポートされていない画像タイプ」エラーの場合は、コンテンツタイプの処理を確認してください。
サーバー出力でエラーメッセージを探します

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

MCP Image Server

Integrations