MCP Server Giphy

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>"
      }
    }
  }
}

开发

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

# Use with MCP Inspector
npm run inspector

许可证

此 MCP 服务采用 MIT License 许可。这意味着您可以自由使用、修改和分发此软件，但须遵守 MIT License 的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。