MCP Server Giphy
@magarcia
An implementation of Giphy integration with Model Context Protocol
Overview
What is MCP Server Giphy?
MCP Server Giphy is a Model Context Protocol server that enables AI models to search, retrieve, and utilize GIFs from Giphy. It integrates with the Giphy API and is intended for developers building AI-powered applications that need GIF capabilities.
How to use MCP Server Giphy?
Obtain a Giphy API key from the Giphy developer dashboard, then set it as the GIPHY_API_KEY environment variable. For usage with Claude Desktop, add the server configuration to your claude_desktop_config.json with the command npx -y mcp-server-giphy and the API key. The server exposes three tools: search_gifs, get_random_gif, and get_trending_gifs.
Key features of MCP Server Giphy
- Content filtering by rating (G, PG, PG-13, R)
- Optimized response format for AI model consumption
- Query-based, random, and trending GIF retrieval
- Comprehensive metadata including dimensions, formats, and attribution
- Pagination support with configurable result size and offset
Use cases of MCP Server Giphy
- AI assistants that need to find and return relevant GIFs based on user queries
- Chatbots that can respond with random or trending GIFs to engage users
- Applications requiring custom GIF searches with content rating controls
FAQ from MCP Server Giphy
What tools does MCP Server Giphy provide?
It provides three tools: search_gifs (search by query with optional limit, offset, rating, and language), get_random_gif (get a random GIF optionally filtered by tag and rating), and get_trending_gifs (get currently trending GIFs with optional limit, offset, and rating).
What data is included in each GIF response?
Each GIF includes its unique Giphy ID, title, URL on Giphy, and an images object containing direct URLs, widths, and heights for various image formats, plus additional metadata when available.
How do I configure the server with an API key?
Set the GIPHY_API_KEY environment variable to your Giphy API key. For Claude Desktop, add it to the server's env field in claude_desktop_config.json.
What runtime or dependencies are required?
The server is an npm package; you need Node.js to run it via npx. Dependencies are installed automatically when using npx -y.
Is there any content safety or filtering?
Yes, you can filter results by rating (g, pg, pg-13, r) using the optional rating input parameter on all three tools.