MCP Server Giphy

MCP Server Giphy

MCP-compatible Giphy API server for AI models to search and retrieve GIFs.

View on GitHub
22
Stars
8
Forks
22
Watchers
2
Issues
MCP Server Giphy provides an MCP-compliant server interface for accessing GIFs from the Giphy API, specifically tailored for seamless integration with AI models. It supports content filtering, multiple retrieval methods (search, trending, random), and optimized response formats with comprehensive metadata. The server enables AI applications to search, retrieve, and utilize GIF content efficiently, and is easily configurable with tools like Claude Desktop.

Key Features

Content filtering by rating (G, PG, PG-13, R)
Optimized response format for AI consumption
Search, random, and trending GIF retrieval methods
Comprehensive GIF metadata in responses
Pagination and result size controls
Support for language targeting in search
Easy setup using environment variables
Integration with Claude Desktop and MCP Inspector
Supports direct querying via standardized tools
Mit licensed open source code

Use Cases

Empowering AI chatbots to fetch and share relevant GIFs in conversations
Enhancing digital assistants with GIF search and recommendation capabilities
Integrating GIF-based content into creative AI applications
Content moderation workflows using filtered GIF retrieval
Providing media-rich responses in virtual agent solutions
Personalizing user experiences with trending and random GIF suggestions
Rapid prototyping of AI systems requiring GIF content access
Facilitating user-generated content in social or messaging apps
Automating GIF curation pipelines for specific queries or trends
Testing and validating GIF integration in AI-powered workflows

README

MCP Server Giphy

CI npm version npm downloads License: MIT

MCP Server for the Giphy API, enabling AI models to search, retrieve, and utilize GIFs from Giphy.

Features

  • Content Filtering: Filter results by rating (G, PG, PG-13, R) to ensure appropriate content
  • Optimized Response Format: Response data optimized for AI model consumption
  • Multiple Search Methods: Support for query-based, random, and trending GIF retrieval
  • Comprehensive Metadata: Each GIF comes with full metadata including dimensions, formats, and attribution
  • Pagination Support: Control result size and pagination for efficient API use

Tools

  1. search_gifs

    • Search for GIFs on Giphy with a query string
    • Inputs:
      • query (string): Search query term or phrase
      • limit (optional number): Maximum number of objects to return (default: 10, max: 50)
      • offset (optional number): Results offset (default: 0)
      • rating (optional string): Content rating (g, pg, pg-13, r)
      • lang (optional string): Language code (default: en)
    • Returns: Array of GIF objects with metadata

  2. get_random_gif

    • Get a random GIF from Giphy, optionally filtered by tag
    • Inputs:
      • tag (optional string): Tag to limit random results
      • rating (optional string): Content rating (g, pg, pg-13, r)
    • Returns: Random GIF object with metadata

  3. get_trending_gifs

    • Get currently trending GIFs on Giphy
    • Inputs:
      • limit (optional number): Maximum number of objects to return (default: 10, max: 50)
      • offset (optional number): Results offset (default: 0)
      • rating (optional string): Content rating (g, pg, pg-13, r)
    • Returns: Array of trending GIF objects with metadata

Response Format

Each GIF in the response includes:

  • id: Unique Giphy identifier
  • title: GIF title
  • url: URL to the GIF on Giphy website
  • images: Object containing various image formats, each with:
    • url: Direct URL to the image file
    • width: Image width
    • height: Image height
  • Additional metadata when available

Setup

Giphy API Key

Create a Giphy API Key:

  • Sign up for a Giphy Developer account
  • Create an app to get an API key
  • Choose between the free tier or paid options based on your needs

Environment Configuration

Create a .env file with your API key:

GIPHY_API_KEY=your_api_key_here

Usage with Claude Desktop

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

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

Development

bash
# 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

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Star History

Star History Chart

Repository Owner

magarcia
magarcia

User

Repository Details

Language TypeScript
Default Branch main
Size 423 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
89.44%
JavaScript
9.32%
Dockerfile
1.24%

Tags

AI-integration API server

Topics

giphy giphy-api mcp-server model-context-protocol

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • TikTok MCP

    TikTok MCP

    Integrate TikTok video analysis and search into AI systems via the Model Context Protocol.

    TikTok MCP enables integration of TikTok video access and analysis into AI applications such as Claude AI using the Model Context Protocol. It provides tools to extract subtitles, retrieve video details, and search TikTok content, facilitating contextual understanding for models. Built on Node.js and requiring a TikNeuron API key, it offers seamless connectivity between AI systems and TikTok's data. The tool supports retrieving metadata, engagement metrics, and advanced search with pagination capabilities.

    • ⭐ 112
    • MCP
    • Seym0n/tiktok-mcp
  • MyMCP Server (All-in-One Model Context Protocol)

    MyMCP Server (All-in-One Model Context Protocol)

    Powerful and extensible Model Context Protocol server with developer and productivity integrations.

    MyMCP Server is a robust Model Context Protocol (MCP) server implementation that integrates with services like GitLab, Jira, Confluence, YouTube, Google Workspace, and more. It provides AI-powered search, contextual tool execution, and workflow automation for development and productivity tasks. The system supports extensive configuration and enables selective activation of grouped toolsets for various environments. Installation and deployment are streamlined, with both automated and manual setup options available.

    • ⭐ 93
    • MCP
    • nguyenvanduocit/all-in-one-model-context-protocol
  • OpenAI MCP Server

    OpenAI MCP Server

    Bridge between Claude and OpenAI models using the MCP protocol.

    OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.

    • ⭐ 77
    • MCP
    • pierrebrunelle/mcp-server-openai
  • @nanana-ai/mcp-server-nano-banana

    @nanana-ai/mcp-server-nano-banana

    MCP server for Nanana AI image generation using Gemini's nano banana model.

    @nanana-ai/mcp-server-nano-banana serves as an MCP (Model Context Protocol) compatible server for facilitating image generation and transformation powered by the Gemini nano banana model. It enables clients like Claude Desktop to interact with Nanana AI, processing text prompts to generate images or transform existing images. The server can be easily configured with API tokens and integrated into desktop applications. Users can manage credentials, customize endpoints, and monitor credit usage seamlessly.

    • ⭐ 3
    • MCP
    • nanana-app/mcp-server-nano-banana
  • Bing Search MCP Server

    Bing Search MCP Server

    MCP server enabling Bing-powered web, news, and image search for AI assistants.

    Bing Search MCP Server provides a Model Context Protocol (MCP) compliant interface for integrating Microsoft Bing Search API capabilities with AI assistants. The server allows AI clients to perform web, news, and image searches programmatically, with features like rate limiting and comprehensive error handling. Designed for easy deployment, it supports integration with clients such as Claude Desktop and Cursor for enhanced search access. Secure configuration via environment variables enables safe use of API keys.

    • ⭐ 65
    • MCP
    • leehanchung/bing-search-mcp
  • GIF Creator MCP

    GIF Creator MCP

    Convert videos to high-quality GIF animations via MCP.

    GIF Creator MCP is a Model Context Protocol (MCP) server designed to convert video files into GIF animations. It allows users to customize output settings, such as frames per second, dimensions, and duration, and can extract specific portions of videos. The tool supports high-quality GIF generation and integrates with clients like Goose for easy extension. Video processing leverages FFmpeg and outputs GIFs with optimized palettes.

    • ⭐ 11
    • MCP
    • ananddtyagi/gif-creator-mcp
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results