关键词

GIF搜索Giphy图像内容检索工具服务

项目简介

mcp-server-giphy 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型（LLM）应用提供访问 Giphy GIF 搜索和检索功能。通过该服务器，LLM 可以利用 Giphy 强大的 GIF 库，根据用户查询搜索相关的 GIF 动图，或者获取随机和热门的 GIF，从而增强 LLM 应用的互动性和表达能力。

主要功能点

  • GIF 搜索: 支持关键词查询，帮助 LLM 根据文本描述找到相关的 GIF 动图。
  • 随机 GIF: 获取符合指定标签或内容分级的随机 GIF，增加内容的多样性。
  • 热门 GIF: 检索 Giphy 平台上的热门 GIF 动图，了解当下流行趋势。
  • 内容分级过滤: 支持根据内容分级（G, PG, PG-13, R）过滤搜索结果，确保内容适宜性。
  • 优化的响应格式: 返回的数据格式经过优化，方便 LLM 理解和使用。

安装步骤

  1. 安装 mcp-server-giphy: 您可以通过 Smithery CLI 快速安装，或者使用 npm 进行手动安装。

    • 使用 Smithery CLI (推荐 Claude Desktop 用户):

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

    • 使用 npm 手动安装:

      npm install -g mcp-server-giphy

  2. 获取 Giphy API 密钥: 访问 Giphy 开发者平台 注册并创建一个应用，获取 API 密钥。您可以选择免费或付费的 API 方案。

  3. 配置环境变量: 创建 '.env' 文件，并将您的 Giphy API 密钥配置到环境变量 'GIPHY_API_KEY' 中。

    GIPHY_API_KEY=YOUR_GIPHY_API_KEY

服务器配置

对于 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加 mcp-server-giphy 服务器的配置信息。以下是 Claude Desktop 'claude_desktop_config.json' 的配置示例：

{
  "mcpServers": {
    "giphy": {  // 服务器名称，客户端用此名称引用
      "command": "npx", // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": ["-y", "mcp-server-giphy"], // 命令参数，这里指定运行 mcp-server-giphy 包
      "env": { // 环境变量配置
        "GIPHY_API_KEY": "<YOUR_API_KEY>" // Giphy API 密钥，请替换为您的实际密钥
      }
    }
  }
}

配置说明:

  • '"giphy"': 您为该 MCP 服务器指定的名称，在客户端配置中用于引用。
  • '"command": "npx"': 指定运行服务器的命令为 'npx'，用于执行 npm 包。
  • '"args": ["-y", "mcp-server-giphy"]': 'npx' 命令的参数，'-y' 表示自动确认安装包，'mcp-server-giphy' 是要运行的 npm 包名称。
  • '"env": { "GIPHY_API_KEY": "<YOUR_API_KEY>" }': 设置环境变量，'GIPHY_API_KEY' 用于服务器访问 Giphy API，请将 '<YOUR_API_KEY>' 替换为您在 Giphy 开发者平台获取的 API 密钥。

基本使用方法

配置完成后，您的 MCP 客户端（如 Claude Desktop）就可以连接到 mcp-server-giphy 服务器。LLM 可以通过调用服务器提供的工具（Tools）来使用 Giphy 的 GIF 搜索功能。

例如，LLM 可以调用 'search_gifs' 工具，并提供查询关键词 (query) 和其他可选参数（如 limit, rating）来搜索相关的 GIF 动图。服务器会将搜索结果以 JSON 格式返回给 LLM，LLM 可以解析 JSON 数据并利用 GIF 信息进行后续操作。

具体工具的使用方法和参数请参考仓库 README.md 文件中 "Tools" 部分的详细描述。

信息

分类

网页与API

访问项目