MCP Server Giphy

by magarcia
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables search, retrieval, and utilization of GIFs from Giphy, with features for content filtering by rating, multiple search methods (query-based, random, trending), pagination support, and comprehensive metadata for each GIF.

MCP 服务器 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>" } } } }

发展

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

-
security - not tested
A
license - permissive license
-
quality - not tested

通过内容过滤、多种搜索方法和全面的元数据等功能,使 AI 模型能够搜索、检索和利用来自 Giphy 的 GIF。

  1. Features
    1. Tools
      1. Response Format
        1. Setup
          1. Installing via Smithery
          2. Giphy API Key
          3. Environment Configuration
          4. Usage with Claude Desktop
        2. Development
          1. License
            ID: roajz0npwj