MCP Openverse

🚀 @mcp/openverse

@mcp/openverseは、Openverseからオープンライセンスの画像を検索および取得するためのツールを提供するMCP（Model Context Protocol）サーバーです。

✨ 主な機能

• 🔍 CCライセンスおよびパブリックドメインの画像を検索
• 🎨 ライセンスタイプ、ソース、ファイル形式などでフィルタリング
• 📊 帰属表示を含む詳細な画像情報を取得
• 🔗 関連する画像を検索
• 📝 エッセイや記事をイラストレーションするための画像を検索
• ⚡ TypeScriptとfastmcpで構築され、優れたパフォーマンスを実現

📦 インストール

npmを使用したグローバルインストール

npm install -g @mcp/openverse

ソースからのインストール

git clone https://github.com/yourusername/mcp-openverse.git
cd mcp-openverse
npm install
npm run build
npm link

💻 使用例

MCPサーバーとしての使用

Claude Desktopの設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "openverse": {
      "command": "npx",
      "args": ["@mcp/openverse"]
    }
  }
}

ローカルにインストールした場合は、以下のように設定します。

{
  "mcpServers": {
    "openverse": {
      "command": "node",
      "args": ["/path/to/mcp-openverse/dist/index.js"]
    }
  }
}

利用可能なツール

search_images

様々なフィルターを使用してオープンライセンスの画像を検索します。

パラメーター:

• query (必須): 検索用語
• page: ページ番号（デフォルト: 1）
• page_size: ページあたりの結果数（デフォルト: 20, 最大: 500）
• license: ライセンスタイプ (by, by-sa, by-nc, by-nd, cc0 など)
• license_type: commercial または modification
• creator: クリエイター名でフィルタリング
• source: ソースでフィルタリング (flickr, wikimedia, met など)
• extension: ファイルタイプ (jpg, png, gif, svg)
• aspect_ratio: tall, wide, または square
• size: small, medium, または large
• mature: 成人向けコンテンツを含める（デフォルト: false）

例:

// 商用ライセンスの自然写真を検索
{
  "query": "forest landscape",
  "page_size": 10,
  "license_type": "commercial",
  "extension": "jpg",
  "aspect_ratio": "wide"
}

get_image_details

特定の画像の詳細情報を取得します。

パラメーター:

• image_id (必須): Openverseの画像ID（UUID形式）

get_related_images

特定の画像に関連する画像を検索します。

パラメーター:

• image_id (必須): 関連画像を検索するための画像ID
• page: ページ番号（デフォルト: 1）
• page_size: ページあたりの結果数（デフォルト: 10）

get_image_stats

ソース別の利用可能な画像の統計情報を取得します。

パラメーター: 不要

search_images_for_essay

エッセイや記事をイラストレーションするための画像を検索するための高度なツールです。

パラメーター:

• essay_topic (必須): エッセイの主要なトピック/タイトル
• concepts (必須): 画像を検索するための主要概念の配列
• style: photo, illustration, または any（デフォルト: any）
• max_images: 返す最大画像数（デフォルト: 10）

例:

{
  "essay_topic": "Climate Change",
  "concepts": ["global warming", "renewable energy", "carbon emissions"],
  "style": "photo",
  "max_images": 15
}

画像の帰属表示

Openverseからのすべての画像には帰属表示が必要です。APIは以下を提供します。

• attribution: 事前にフォーマットされた帰属表示テキスト
• license: ライセンスコード（例: 'by-sa'）
• license_url: ライセンスへのリンク
• creator: 元のクリエイター/写真家
• creator_url: クリエイターのプロフィールへのリンク

画像を使用する際には常に適切な帰属表示を行ってください。

レート制限

Openverse APIには以下のレート制限があります。

• 匿名アクセス: 1日100リクエスト、1時間5リクエスト
• 認証済みアクセス: 1日10,000リクエスト、1分100リクエスト

このMCPサーバーは現在、匿名アクセスを使用しています。より高いレート制限が必要な場合は、OAuth認証を実装してください。

開発

ソースからのビルド

npm install
npm run build

開発モードでの実行

npm run dev

サーバーのテスト

MCPインスペクターを使用してサーバーをテストできます。

npx @modelcontextprotocol/inspector dist/index.js

利用例

ブログ記事用の画像を検索

// search_images_for_essayツールを使用
{
  "essay_topic": "Sustainable Architecture",
  "concepts": ["green building", "solar panels", "eco-friendly design"],
  "style": "photo",
  "max_images": 10
}

特定の要件で検索

// search_imagesツールを使用
{
  "query": "mountain landscape sunrise",
  "aspect_ratio": "wide",
  "license_type": "commercial",
  "extension": "jpg",
  "size": "large",
  "page_size": 20
}

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

コントリビューション

コントリビューションを歓迎します！プルリクエストを自由に送信してください。

開発ガイドライン

1. TypeScriptのベストプラクティスに従ってください。
2. 新機能にはテストを追加してください。
3. ドキュメントを更新してください。
4. すべてのツールに適切なエラーハンドリングを実装してください。

謝辞

• Openverse がAPIとオープンライセンスのコンテンツを提供してくれたことに感謝します。
• WordPress がOpenverseプロジェクトを維持管理してくれたことに感謝します。
• fastmcp が優れたMCPフレームワークを提供してくれたことに感謝します。

トラブルシューティング

一般的な問題

1. レート制限エラー: 匿名APIのレート制限に達しています。1時間待つか、認証を実装してください。
2. 結果が得られない: より広い検索用語を試すか、フィルターを削除してください。
3. 接続エラー: インターネット接続とファイアウォール設定を確認してください。

デバッグモード

DEBUG 環境変数を設定します。

DEBUG=mcp:* npx @mcp/openverse