Giphy

🚀 Giphy GIF MCP 服務器

Giphy GIF MCP 服務器可讓 AI 模型搜索、檢索並使用來自 Giphy 的 GIF，為 AI 應用帶來豐富的動態圖像資源。

🚀 快速開始

若想使用本服務器，可參考以下安裝方式開啟使用之旅。

✨ 主要特性

• 內容過濾：可按評級（G, PG, PG - 13, R）篩選結果，確保使用的內容符合要求。
• 優化的響應格式：響應數據針對 AI 模型消費進行了優化，便於 AI 模型處理。
• 多種搜索方法：支持基於查詢、隨機和熱門 GIF 的檢索，滿足不同場景需求。
• 全面元數據：每個 GIF 都附帶完整的元數據，包含尺寸、格式和歸屬信息等。
• 分頁支持：能夠控制結果數量和分頁，高效使用 API。

📦 安裝指南

使用 Smithery 安裝

1. 訪問 Smithery。
2. 搜索並選擇 mcp - server - giphy 項目。
3. 點擊“部署”按鈕，根據提示完成安裝。

手動安裝

1. 克隆倉庫：

git clone https://github.com/magarcia/mcp-server-giphy.git

2. 安裝依賴項：

cd mcp-server-giphy
npm install

3. 啟動服務器：

npm start

💻 使用示例

基礎用法

本服務器提供了多個實用工具，以下是各工具的使用示例：

search_gifs

使用查詢字符串在 Giphy 上搜索 GIF。

# 示例代碼，假設存在調用該工具的函數
result = search_gifs(query="可愛貓咪", limit=20, rating="pg")

輸入參數說明：

• query（字符串）：搜索查詢詞或短語。
• limit（可選數字）：最多返回對象的數量（默認：10，最大：50）。
• offset（可選數字）：結果偏移量（默認：0）。
• rating（可選字符串）：內容評級（g, pg, pg - 13, r）。
• lang（可選字符串）：語言代碼（默認：en）。 返回值：包含元數據的 GIF 對象數組。

get_random_gif

從 Giphy 獲取一個隨機 GIF，可選按標籤過濾。

# 示例代碼，假設存在調用該工具的函數
random_gif = get_random_gif(tag="搞笑", rating="g")

輸入參數說明：

• tag（可選字符串）：用於限制隨機結果的標籤。
• rating（可選字符串）：內容評級（g, pg, pg - 13, r）。 返回值：包含元數據的隨機 GIF 對象。

get_trending_gifs

獲取 Giphy 上當前熱門的 GIF。

# 示例代碼，假設存在調用該工具的函數
trending_gifs = get_trending_gifs(limit=15)

輸入參數說明：

• limit（可選數字）：最多返回對象的數量（默認：10，最大：50）。
• offset（可選數字）：結果偏移量（默認：0）。 返回值：包含元數據的熱門 GIF 對象數組。

📚 詳細文檔

響應格式

每個工具的響應將返回以下結構：

{
  " gifs ": [
    {
      " id ": string,
      " url ": string,
      " width ": number,
      " height ": number,
      " username ": string,
      " avatar_url ": string,
      " is_sticky ": boolean,
      " created_at ": string,
      " updated_at ": string
    }
  ]
}

📄 許可證

此項目根據 MIT 許可證授權。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。更多詳情，請參閱項目倉庫中的 LICENSE 文件。

項目倉庫

https://github.com/magarcia/mcp-server-giphy

貢獻指南

請參考 貢獻指南。