MCP Server Giphy

基本能力

产品定位

mcp-server-giphy 是一个连接 Giphy API 的中间件服务，专门为 AI 模型提供 GIF 动图搜索和检索功能。

核心功能

• 内容过滤：支持按评级（G、PG、PG-13、R）过滤结果，确保内容适当性
• 优化的响应格式：响应数据针对 AI 模型消费进行了优化
• 多种搜索方法：支持基于查询的搜索、随机获取和热门 GIF 检索
• 全面的元数据：每个 GIF 都包含完整的元数据，包括尺寸、格式和归属信息
• 分页支持：控制结果大小和分页，提高 API 使用效率

适用场景

• AI 聊天机器人需要返回 GIF 动图作为响应
• 内容创作工具需要集成 GIF 素材
• 社交媒体分析工具需要获取热门 GIF 趋势

工具列表

1. search_gifs
2. 功能：使用查询字符串在 Giphy 上搜索 GIF
3. 输入参数：查询字符串、结果限制、偏移量、内容评级和语言代码

4. 返回：带有元数据的 GIF 对象数组

5. get_random_gif

6. 功能：从 Giphy 获取随机 GIF，可选择按标签过滤
7. 输入参数：可选标签和内容评级

8. 返回：带有元数据的随机 GIF 对象

9. get_trending_gifs

10. 功能：获取 Giphy 上当前热门的 GIF
11. 输入参数：结果限制、偏移量和内容评级
12. 返回：带有元数据的流行 GIF 对象数组

常见问题解答

• 需要 Giphy API 密钥才能使用此服务
• 免费和付费 API 选项可根据需求选择
• 响应格式已针对 AI 模型进行了优化

使用教程

使用依赖

1. 需要 Node.js 环境
2. 需要 Giphy API 密钥

安装教程

1. 通过 Smithery 安装：

npx -y @smithery/cli install mcp-server-giphy --client claude

1. 获取 Giphy API 密钥：
2. 注册 Giphy 开发者账号

3. 创建应用获取 API 密钥

4. 环境配置： 创建 .env 文件并添加：

GIPHY_API_KEY=your_api_key_here

调试方式

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

# 开发模式（热重载）
npm run dev

# 运行测试
npm test

# 使用 MCP 检查器
npm run inspector

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。