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

贡献指南

请参考 贡献指南。