magarcia

@magarcia/mcp-server-giphy

0 Stars 324 次浏览 magarcia 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "giphy": {
      "args": [
        "-y",
        "mcp-server-giphy"
      ],
      "command": "npx",
      "env": {
        "GIPHY_API_KEY": "\u003cYOUR_API_KEY\u003e"
      }
    }
  }
}

服务介绍

MCP Server Giphy

MCP Server 用于 Giphy API，使 AI 模型能够搜索、检索和使用来自 Giphy 的 GIF。

功能

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

工具

search_gifs
- 使用查询字符串在 Giphy 上搜索 GIF
- 输入：
  - query (字符串)：搜索查询词或短语
  - limit (可选数字)：返回的最大对象数量（默认：10，最大：50）
  - offset (可选数字)：结果偏移量（默认：0）
  - rating (可选字符串)：内容评级（g, pg, pg-13, r）
  - lang (可选字符串)：语言代码（默认：en）
- 返回：带有元数据的 GIF 对象数组
get_random_gif
- 从 Giphy 获取一个随机 GIF，可选择按标签过滤
- 输入：
  - tag (可选字符串)：限制随机结果的标签
  - rating (可选字符串)：内容评级（g, pg, pg-13, r）
- 返回：带有元数据的随机 GIF 对象
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 中：

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

开发

bash

安装依赖

npm install

构建项目

npm run build

启动服务器

npm start

以开发模式运行并启用热重载

npm run dev

运行测试

npm test

使用 MCP Inspector

npm run inspector

许可证

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

查看源码项目主页