giphy.com
giphy.com logo

Giphy

Submit recent chat history ('context') and a search term to retrieve a list of candidate results from GIPHY and load the...

Created byApr 22, 2025

MCP GIPHY Server

Overview

This project implements a Model Context Protocol (MCP) server integration with the GIPHY API. The server allows an assistant to submit recent chat history ('context') and a search term to retrieve a list of candidate results from GIPHY and load their image data.

Features

  • Search and Retrieve: Uses the GIPHY API to search for images based on a provided search term.
  • (Future) Sampling: Employs the MCP "sampling" feature to request the assistant to choose the most appropriate image for the context.
  • Integration: The selected GIPHY image and its metadata are returned to the original assistant tool call, enabling it to be included in assistant responses to users.

Setup and Installation

Simply run:
To create the virtual environment and install dependencies.

Running the Server

Use the VSCode launch configuration, or run manually:
Defaults to stdio transport:
For SSE transport:
The SSE URL is:

Client Configuration

To use this MCP server in your setup, consider the following configuration:

UV - Local files

SSE

Ensure that GIPHY_API_KEY is set in your environment so that the server can authenticate with the GIPHY API.

MCP GIPHY Server

Overview

This project implements a Model Context Protocol (MCP) server integration with the GIPHY API. The server allows an assistant to submit recent chat history ('context') and a search term to retrieve a list of candidate results from GIPHY and load their image data.

Features

  • Search and Retrieve: Uses the GIPHY API to search for images based on a provided search term.
  • (Future) Sampling: Employs the MCP "sampling" feature to request the assistant to choose the most appropriate image for the context.
  • Integration: The selected GIPHY image and its metadata are returned to the original assistant tool call, enabling it to be included in assistant responses to users.

Setup and Installation

Simply run:
To create the virtual environment and install dependencies.

Running the Server

Use the VSCode launch configuration, or run manually:
Defaults to stdio transport:
For SSE transport:
The SSE URL is:

Client Configuration

To use this MCP server in your setup, consider the following configuration:

UV - Local files

SSE

Ensure that GIPHY_API_KEY is set in your environment so that the server can authenticate with the GIPHY API.