mcp-server-giphy 是一款 MCP 服务器，旨在为 AI 模型提供便捷的 Giphy API 访问能力。通过它，AI 模型可以轻松搜索、检索并利用 Giphy 上的海量 GIF 资源，从而显著增强其内容生成和交互能力。该服务器支持多种搜索方式，包括关键词查询、随机 GIF 获取和热门 GIF 检索，并提供内容分级过滤，确保返回适宜的内容。每个 GIF 都包含完整的元数据，如尺寸、格式和来源信息，方便 AI 模型理解和使用。开发者可以通过 Smithery 快速安装，并配置 Giphy API 密钥即可使用。mcp-server-giphy 优化了响应格式，使 AI 模型能够高效地解析和利用 GIF 数据，极大地扩展了 AI 应用的创意空间。通过集成 mcp-server-giphy，开发者可以轻松地为 AI 模型添加生动有趣的视觉元素，提升用户体验。

GIF 搜索与检索

mcp-server-giphy 的核心功能是使 AI 模型能够通过 Giphy API 搜索和检索 GIF。它允许模型根据关键词查询 Giphy 的庞大 GIF 库，并获取相关的 GIF 对象。该功能通过 search_gifs 工具实现，接受查询字符串作为输入，并返回一个包含 GIF 元数据的数组。这些元数据包括 GIF 的唯一标识符、标题、URL 以及各种图像格式的 URL、宽度和高度。此功能极大地扩展了 AI 模型的内容生成能力，使其能够根据上下文动态地插入相关的视觉元素，从而增强用户体验。例如，一个聊天机器人可以根据用户的情绪或话题，搜索并发送相应的 GIF，使对话更生动有趣。技术上，该功能通过调用 Giphy API 的 /gifs/search 端点实现，并对返回的数据进行优化，使其更易于 AI 模型解析和使用。

随机 GIF 获取

除了搜索功能，mcp-server-giphy 还支持从 Giphy 获取随机 GIF。通过 get_random_gif 工具，AI 模型可以获取一个随机的 GIF 对象，可以选择通过标签进行过滤。这对于需要为用户提供惊喜或随机内容的应用场景非常有用。例如，一个 AI 助手可以在用户感到无聊时，发送一个随机的有趣 GIF 来活跃气氛。或者，一个内容生成模型可以利用随机 GIF 作为灵感来源，生成更具创意的内容。该功能通过调用 Giphy API 的 /gifs/random 端点实现，并支持通过 tag 参数指定标签，从而控制随机 GIF 的主题。此外，还可以通过 rating 参数过滤内容分级，确保返回的 GIF 符合用户的偏好和安全要求。

Trending GIF 获取

mcp-server-giphy 允许 AI 模型获取 Giphy 上当前流行的 GIF。通过 get_trending_gifs 工具，模型可以检索一个包含当前热门 GIF 对象的数组。这使得 AI 模型能够及时了解最新的网络文化和流行趋势，并将其融入到内容生成或交互中。例如，一个社交媒体管理工具可以使用 trending GIF 来增强帖子的吸引力，或者一个新闻聚合应用可以使用 trending GIF 来突出显示热门话题。该功能通过调用 Giphy API 的 /gifs/trending 端点实现，并支持通过 limit 和 offset 参数控制返回结果的数量和分页。此外，还可以通过 rating 参数过滤内容分级，确保返回的 GIF 符合用户的偏好和安全要求。

内容分级过滤

mcp-server-giphy 提供了内容分级过滤功能，允许开发者控制 AI 模型可以访问的 GIF 内容的成熟度。通过在 search_gifs、get_random_gif 和 get_trending_gifs 工具中指定 rating 参数，可以限制返回的 GIF 的内容分级，例如 g、pg、pg-13 或 r。这对于确保 AI 模型生成的内容符合道德规范和用户偏好至关重要。例如，一个面向儿童的 AI 应用应该只允许访问 g 级 GIF，而一个面向成人的应用可以允许访问更高级别的 GIF。该功能通过直接传递 rating 参数给 Giphy API 实现，从而利用 Giphy 自身的内容分级机制。

优化响应格式

mcp-server-giphy 对 Giphy API 返回的原始数据进行了优化，使其更易于 AI 模型解析和使用。响应数据被格式化为包含 GIF 关键信息的 JSON 对象，例如 GIF 的唯一标识符、标题、URL 以及各种图像格式的 URL、宽度和高度。这种优化的响应格式简化了 AI 模型的数据处理流程，提高了开发效率。例如，AI 模型可以直接从响应对象中提取 GIF 的 URL，而无需进行复杂的字符串解析或数据转换。此外，mcp-server-giphy 还提供了全面的元数据，例如 GIF 的尺寸和格式，使 AI 模型能够更好地理解和利用 GIF 资源。