GIF搜索服务

MCP服务器Giphy

用于Giphy API的MCP服务器，使人工智能模型能够搜索、检索和利用Giphy的GIF。

特性

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

工具

1. search_gifs

   • 使用查询字符串在Giphy上搜索GIF
   • 输入：
     • query （string）：搜索查询词或短语
     • 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 Developer帐户
• 创建应用程序以获取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许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。