JinDaGe - giphy MCP Details

article

README

🚀 Giphy GIF MCP 服务器

Giphy GIF MCP 服务器是一个针对 Giphy API 的 MCP 服务器，它让 AI 模型能够便捷地搜索、检索并使用来自 Giphy 的 GIF，为 AI 应用在多媒体素材获取方面提供了有力支持。

✨ 主要特性

内容过滤：可以按照评级（G, PG, PG - 13, R）对搜索结果进行筛选，有效确保获取到适当的内容。
优化的响应格式：响应数据针对 AI 模型的消费需求进行了优化，便于 AI 模型处理和使用。
多种搜索方法：支持基于查询、随机和热门 GIF 的检索方式，满足不同场景下的使用需求。
全面元数据：每个 GIF 都附带完整的元数据，包括尺寸、格式和归属信息等，方便用户了解和使用。
分页支持：能够控制结果数量和分页，从而高效地使用 API，避免数据冗余。

📦 安装指南

使用 Smithery 安装

访问 Smithery。
搜索并选择 mcp-server-giphy 项目。
点击“部署”按钮，然后根据提示完成安装。

手动安装

克隆仓库：

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

安装依赖项：

cd mcp-server-giphy
npm install

启动服务器：

npm start

💻 使用示例

基础用法

搜索 GIF

# 使用 search_gifs 工具搜索 GIF
# 这里假设使用 Python 调用 API，实际情况可能需要根据具体 API 调用方式调整
import requests

query = "cat"
limit = 10
offset = 0
rating = "g"
lang = "en"

url = f"https://your-api-url/search_gifs?query={query}&limit={limit}&offset={offset}&rating={rating}&lang={lang}"
response = requests.get(url)
print(response.json())

获取随机 GIF

# 使用 get_random_gif 工具获取随机 GIF
tag = "funny"
rating = "pg"

url = f"https://your-api-url/get_random_gif?tag={tag}&rating={rating}"
response = requests.get(url)
print(response.json())

获取热门 GIF

# 使用 get_trending_gifs 工具获取热门 GIF
limit = 15
offset = 0

url = f"https://your-api-url/get_trending_gifs?limit={limit}&offset={offset}"
response = requests.get(url)
print(response.json())

高级用法

结合分页和多条件搜索

# 搜索包含 "dog" 的 GIF，每页显示 20 条结果，从第 2 页开始
query = "dog"
limit = 20
offset = 20
rating = "pg-13"
lang = "fr"

url = f"https://your-api-url/search_gifs?query={query}&limit={limit}&offset={offset}&rating={rating}&lang={lang}"
response = requests.get(url)
print(response.json())

📚 详细文档

工具说明

`search_gifs`

功能：使用查询字符串在 Giphy 上搜索 GIF。
输入：
- query（字符串）：搜索查询词或短语。
- limit（可选数字）：最多返回对象的数量（默认：10，最大：50）。
- offset（可选数字）：结果偏移量（默认：0）。
- rating（可选字符串）：内容评级（g, pg, pg - 13, r）。
- lang（可选字符串）：语言代码（默认：en）。
返回：包含元数据的 GIF 对象数组。

`get_random_gif`

功能：从 Giphy 获取一个随机 GIF，可选按标签过滤。
输入：
- tag（可选字符串）：用于限制随机结果的标签。
- rating（可选字符串）：内容评级（g, pg, pg - 13, r）。
返回：包含元数据的随机 GIF 对象。

`get_trending_gifs`

功能：获取 Giphy 上当前热门的 GIF。
输入：
- 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"
    }
  ]
}

🔧 技术细节

该服务器基于相关技术对 Giphy API 进行封装和扩展，以实现多种搜索功能和优化响应格式。通过对输入参数的处理和对 Giphy API 的调用，将符合条件的 GIF 数据以特定的结构返回给调用者。在分页处理方面，利用 limit 和 offset 参数控制结果的数量和起始位置，确保数据的高效获取。对于内容过滤，根据 rating 参数筛选出符合评级要求的 GIF。

📄 许可证

此项目根据 MIT 许可证授权。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

项目仓库

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

贡献指南

请参考贡献指南。

giphy