Wikimedia Image Search

Wikimedia Image Search MCP サーバー

この MCP（Model Context Protocol）サーバーを使うと、AI アシスタントは Wikimedia Commons で画像を検索できます。詳細なメタデータと、任意でサムネイルをまとめた画像を提供するため、AI モデルは検索結果を視覚的に比較できます。

概要

このサーバーは、視覚コンテンツを検索する際に AI アシスタントに「目」を与えることを目的としています。ファイル名やテキストの説明だけを頼りに推測するのではなく、AI は画像のメタデータを構造化した一覧と、検索結果のサムネイルをまとめた画像を取得できます。

この機能は、特に次のような場合に便利です。

• ウェブサイト、記事、プレゼンテーションの作成に適した画像を探す。
• 教材や書籍に使う画像を選ぶ。
• 推薦する前に、画像の視覚的な内容を確認する。
• 特定の用途に最も適した画像を選ぶため、複数の画像を比較する。

メタデータ（ライセンス、作者、説明、寸法）と視覚的なプレビューの両方を提供することで、AI は使用またはダウンロードする画像を適切に判断できます。

セットアップ

前提条件

• Node.js：バージョン 18 以降。
• MCP クライアント：VS Code、Cursor、Claude Code、Windsurf、Cline、Claude Desktop などの互換性のあるクライアント。

インストール

このサーバーを使用するには、npx を使って起動するよう MCP クライアントを設定します。

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

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

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

claude mcp add wikimedia-image-search -- npx -y wikimedia-image-search-mcp

ツールの使用方法

このサーバーは、単一のツール wikimedia_search_images を公開します。

ツールのスキーマ

このツールは、次のパラメーターを受け付けます。

• query（文字列、必須）：検索語（例：「sunset ocean」、「eiffel tower」）。
• limit（数値、任意）：返す結果の最大数（デフォルト：9、最大：50）。
• offset（数値、任意）：ページネーションでスキップする結果の数。
• license（文字列、任意）：ライセンスで絞り込みます。選択肢：「all」（デフォルト）または「no_restrictions」（CC0／パブリックドメイン）。
• include_thumbnails（ブール値、任意）：サムネイルをまとめた画像を生成して返すかどうか（デフォルト：true）。

動作の仕組み

1. 取得：このツールは、指定された検索語とフィルターを使用して Wikimedia Commons API にクエリを送信します。画像 URL、メタデータ、ライセンス情報を含む生の JSON データを取得します。
2. 処理：生の JSON レスポンスを解析し、整理された ImageMetadata オブジェクトのリストに変換します。
3. フォーマット：
   • テキスト：メタデータのリストを YAML 形式の文字列に変換します。これにより、AI は結果の概要（ファイルサイズ、寸法、作者、ライセンスなど）を読みやすく構造化されたテキストで確認できます。
   • ビジュアル：include_thumbnails が true の場合、ツールは各結果のサムネイルをダウンロードします。次に、sharp ライブラリを使用してこれらのサムネイルを 1 枚のグリッド画像に合成し、各画像にインデックス番号を重ねて表示します。
4. レスポンス：ツールは、YAML テキストと合成画像（MIME タイプ image/jpeg）を含む複数コンテンツのメッセージを返します。

test-output/ ディレクトリで出力ファイルの例を確認できます。

• wikimediaSearchResults.json：Wikimedia API からの生の JSON レスポンスです。
• formattedSearchResults.txt：YAML 形式のテキストレスポンスです。
• thumbnailComposite.jpeg：生成された検索結果のビジュアルグリッドです。

デモ

開発

このプロジェクトに貢献する場合、またはソースからローカルで実行する場合は、次の手順に従ってください。

1. リポジトリをクローンする：

   git clone https://github.com/yanexr/wikimedia-image-search-mcp.git
   cd wikimedia-image-search-mcp
   

2. 依存関係をインストールする：

   npm install
   # or
   pnpm install
   

3. プロジェクトをビルドする：

   npm run build
   # or
   pnpm run build
   

4. ローカル設定： MCP クライアントを使ってサーバーをローカルでテストするには、設定でビルド済みファイルを指定します。

   {
     "mcpServers": {
       "wikimedia-local": {
         "command": "node",
         "args": [
           "C:/path/to/wikimedia-image-search-mcp/dist/index.js"
         ]
       }
     }
   }
   

5. テストとデバッグ： MCP Inspector を使用すると、サーバーを対話形式でテストできます。

   npm run inspect
   # or
   pnpm run inspect