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: 图像高度
• 可用时的其他元数据

设置

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 mcp-server-giphy：

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

Giphy API 密钥

创建一个 Giphy API 密钥:

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

环境变量配置

创建一个包含您的 API 密钥的 .env 文件：

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 文件。