MCP Server Giphy

MCP Server Giphy

Giphy API 用の MCP サーバーです。AI モデルが Giphy の GIF を検索、取得、利用できるようにします。

特長

• コンテンツのフィルタリング：レーティング（G、PG、PG-13、R）で結果を絞り込み、適切なコンテンツを表示します
• 最適化されたレスポンス形式：AI モデルでの利用に合わせてレスポンスデータを最適化します
• 複数の検索方法：クエリによる検索、ランダム取得、トレンド GIF の取得に対応しています
• 包括的なメタデータ：各 GIF には、寸法、形式、クレジット情報などの完全なメタデータが含まれます
• ページネーション対応：効率的な API 利用のため、結果数とページネーションを制御できます

ツール

1. search_gifs

   • クエリ文字列を使って Giphy の GIF を検索します
   • 入力：
     • query（string）：検索する語句またはフレーズ
     • limit（省略可能な number）：返すオブジェクトの最大数（デフォルト：10、最大：50）
     • offset（省略可能な number）：結果のオフセット（デフォルト：0）
     • rating（省略可能な string）：コンテンツのレーティング（g、pg、pg-13、r）
     • lang（省略可能な string）：言語コード（デフォルト：en）
   • 戻り値：メタデータを含む GIF オブジェクトの配列

2. get_random_gif

   • Giphy からランダムな GIF を取得します。タグによる絞り込みも可能です
   • 入力：
     • tag（省略可能な string）：ランダムな結果を絞り込むタグ
     • rating（省略可能な string）：コンテンツのレーティング（g、pg、pg-13、r）
   • 戻り値：メタデータを含むランダムな GIF オブジェクト

3. get_trending_gifs

   • Giphy で現在トレンドになっている GIF を取得します
   • 入力：
     • limit（省略可能な number）：返すオブジェクトの最大数（デフォルト：10、最大：50）
     • offset（省略可能な number）：結果のオフセット（デフォルト：0）
     • rating（省略可能な string）：コンテンツのレーティング（g、pg、pg-13、r）
   • 戻り値：メタデータを含むトレンド GIF オブジェクトの配列

レスポンス形式

レスポンス内の各 GIF には、次の情報が含まれます。

• id：Giphy の一意の識別子
• title：GIF のタイトル
• url：Giphy のウェブサイト上にある GIF の URL
• images：さまざまな画像形式を含むオブジェクト。それぞれに次の情報が含まれます：
  • url：画像ファイルへの直接 URL
  • width：画像の幅
  • height：画像の高さ
• 利用可能な場合は、追加のメタデータ

セットアップ

Giphy API キー

Giphy API キーを作成します。

• Giphy Developer アカウントに登録します
• API キーを取得するためにアプリを作成します
• 必要に応じて無料プランまたは有料プランを選択します

環境設定

API キーを記載した .env ファイルを作成します。

GIPHY_API_KEY=your_api_key_here

Claude Desktop での使用方法

Claude Desktop で使用するには、次の設定を claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "giphy": {
      "command": "npx",
      "args": ["-y", "mcp-server-giphy"],
      "env": {
        "GIPHY_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

開発

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

# Use with MCP Inspector
npm run inspector

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。