Giphy MCP Server

Overview

The Giphy MCP server enables AI models to search, retrieve, and utilize GIFs from Giphy's vast library. This integration allows AI assistants to enhance conversations with relevant animated content while maintaining appropriate content filtering.

Installation

Prerequisites

Before installing the Giphy MCP server, you need to obtain a Giphy API key:

1. Visit Giphy Developers and create an account
2. Create a new app to get your API key
3. Make note of your API key for configuration

Installation Methods

Using npm

npm install mcp-server-giphy

Using Smithery (Recommended for Claude Desktop)

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

Configuration

1. Create a .env file in your project directory with your Giphy API key:

GIPHY_API_KEY=your_api_key_here

2. Add the MCP server to your client configuration:

For Claude Desktop or other MCP-compatible clients, add the following to your configuration:

"mcpServers": {
  "giphy": {
    "command": "npx",
    "args": ["mcp-server-giphy"]
  }
}

Usage

Once installed and configured, you can use the Giphy MCP to search for and retrieve GIFs in various ways:

Search for GIFs

Use the search_gifs tool to find GIFs based on keywords or phrases. You can control the number of results, content rating, and language.

Get Random GIFs

The get_random_gif tool retrieves a random GIF, optionally filtered by tag and content rating.

Get Trending GIFs

Use get_trending_gifs to retrieve currently popular GIFs on the platform with pagination support.

Content Filtering

All tools support content filtering through the rating parameter:

• g: General audience (suitable for all ages)
• pg: Parental guidance suggested
• pg-13: Parents strongly cautioned (may be inappropriate for children under 13)
• r: Restricted (contains content suitable only for mature audiences)

Response Format

Each GIF in the response includes:

• Unique identifier
• Title
• URL to the GIF on Giphy website
• Various image formats with dimensions
• Additional metadata when available

Docker Support

For containerized environments, you can use the provided Dockerfile:

docker build -t mcp-server-giphy .
docker run -e GIPHY_API_KEY=your_api_key_here -p 3000:3000 mcp-server-giphy

Troubleshooting

• If you encounter authentication errors, verify your Giphy API key is correctly set in the environment variables
• For rate limiting issues, consider implementing caching or reducing the frequency of requests
• Check the server logs for detailed error information