MCP Server Giphy

用于 Giphy API 的 MCP 服务器，使 AI 模型能够搜索、检索并利用来自 Giphy 的 GIF 图。

功能

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

工具

1. search_gifs

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

2. get_random_gif

   • 获取来自 Giphy 的随机 GIF，可选按标签过滤
   • 输入参数：
     • tag (可选字符串)：限制随机结果的标签
     • rating (可选字符串)：内容评级（g、pg、pg-13、r）
   • 返回值：带有元数据的随机 GIF 对象

3. get_trending_gifs

   • 获取当前在 Giphy 上流行的 GIF
   • 输入参数：
     • limit (可选数字)：返回的最大对象数（默认：10，最大：50）
     • offset (可选数字)：结果偏移量（默认：0）
     • rating (可选字符串)：内容评级（g、pg、pg-13、r）
   • 返回值：带有元数据的热门 GIF 对象数组

响应格式

响应中的每个 GIF 包含：

• id：唯一的 Giphy 标识符
• title：GIF 标题
• url：指向 Giphy 网站上 GIF 的 URL
• images：包含各种图像格式的对象，每个格式都包含：
  • url：直接指向图像文件的 URL
  • width：图像宽度
  • height：图像高度
• 可用时提供额外的元数据

设置

Giphy API 密钥

创建一个 Giphy API 密钥：

• 注册一个 Giphy 开发者账户
• 创建一个应用以获取 API 密钥
• 根据需求选择免费层级或付费选项

环境配置

创建一个 .env 文件并添加您的 API 密钥：

GIPHY_API_KEY=your_api_key_here

在 Claude Desktop 中使用

要在 Claude Desktop 中使用此服务，请在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "giphy": {
      "command": "npx",
      "args": ["-y", "mcp-server-giphy"],
      "env": {
        "GIPHY_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

开发

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

# 在开发模式下运行并启用热重载
npm run dev

# 运行测试
npm test

# 使用 MCP Inspector
npm run inspector

许可证

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由地使用、修改和分发该软件，但需遵守 MIT 许可证中的条款和条件。更多详情，请参阅项目存储库中的 LICENSE 文件。