MCP Server Giphy

1# MCP Server Giphy
2 
3[![CI](https://github.com/magarcia/mcp-server-giphy/actions/workflows/ci.yml/badge.svg)](https://github.com/magarcia/mcp-server-giphy/actions/workflows/ci.yml)
4[![npm version](https://img.shields.io/npm/v/mcp-server-giphy.svg)](https://www.npmjs.com/package/mcp-server-giphy)
5[![npm downloads](https://img.shields.io/npm/dm/mcp-server-giphy.svg)](https://www.npmjs.com/package/mcp-server-giphy)
6[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7 
8MCP Server for the Giphy API, enabling AI models to search, retrieve, and utilize GIFs from Giphy.
9 
10### Features
11 
12- **Content Filtering**: Filter results by rating (G, PG, PG-13, R) to ensure appropriate content
13- **Optimized Response Format**: Response data optimized for AI model consumption
14- **Multiple Search Methods**: Support for query-based, random, and trending GIF retrieval
15- **Comprehensive Metadata**: Each GIF comes with full metadata including dimensions, formats, and attribution
16- **Pagination Support**: Control result size and pagination for efficient API use
17 
18## Tools
19 
201. `search_gifs`
21 
22   - Search for GIFs on Giphy with a query string
23   - Inputs:
24     - `query` (string): Search query term or phrase
25     - `limit` (optional number): Maximum number of objects to return (default: 10, max: 50)
26     - `offset` (optional number): Results offset (default: 0)
27     - `rating` (optional string): Content rating (g, pg, pg-13, r)
28     - `lang` (optional string): Language code (default: en)
29   - Returns: Array of GIF objects with metadata
30 
312. `get_random_gif`
32 
33   - Get a random GIF from Giphy, optionally filtered by tag
34   - Inputs:
35     - `tag` (optional string): Tag to limit random results
36     - `rating` (optional string): Content rating (g, pg, pg-13, r)
37   - Returns: Random GIF object with metadata
38 
393. `get_trending_gifs`
40   - Get currently trending GIFs on Giphy
41   - Inputs:
42     - `limit` (optional number): Maximum number of objects to return (default: 10, max: 50)
43     - `offset` (optional number): Results offset (default: 0)
44     - `rating` (optional string): Content rating (g, pg, pg-13, r)
45   - Returns: Array of trending GIF objects with metadata
46 
47## Response Format
48 
49Each GIF in the response includes:
50 
51- `id`: Unique Giphy identifier
52- `title`: GIF title
53- `url`: URL to the GIF on Giphy website
54- `images`: Object containing various image formats, each with:
55  - `url`: Direct URL to the image file
56  - `width`: Image width
57  - `height`: Image height
58- Additional metadata when available
59 
60## Setup
61 
62### Giphy API Key
63 
64[Create a Giphy API Key](https://developers.giphy.com/dashboard/?create=true):
65 
66- Sign up for a Giphy Developer account
67- Create an app to get an API key
68- Choose between the free tier or paid options based on your needs
69 
70### Environment Configuration
71 
72Create a `.env` file with your API key:
73 
74```
75GIPHY_API_KEY=your_api_key_here
76```
77 
78### Usage with Claude Desktop
79 
80To use this with Claude Desktop, add the following to your `claude_desktop_config.json`:
81 
82```json
83{
84  "mcpServers": {
85    "giphy": {
86      "command": "npx",
87      "args": ["-y", "mcp-server-giphy"],
88      "env": {
89        "GIPHY_API_KEY": "<YOUR_API_KEY>"
90      }
91    }
92  }
93}
94```
95 
96## Development
97 
98```bash
99# Install dependencies
100npm install
101 
102# Build the project
103npm run build
104 
105# Start the server
106npm start
107 
108# Run in development mode with hot reloading
109npm run dev
110 
111# Run tests
112npm test
113 
114# Use with MCP Inspector
115npm run inspector
116```
117 
118## License
119 
120This 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.
121