Servidor MCP Giphy

Servidor MCP para la API de Giphy, que permite que los modelos de IA busquen, recuperen y utilicen GIF de Giphy.

Características

• Filtrado de contenido : filtre los resultados por clasificación (G, PG, PG-13, R) para garantizar contenido apropiado

• Formato de respuesta optimizado : datos de respuesta optimizados para el consumo del modelo de IA

• Múltiples métodos de búsqueda : compatibilidad con recuperación de GIF basada en consultas, aleatoria y de tendencias

• Metadatos completos : cada GIF viene con metadatos completos que incluyen dimensiones, formatos y atribución.

• Compatibilidad con paginación : controle el tamaño de los resultados y la paginación para un uso eficiente de la API

Herramientas

1. search_gifs

   • Buscar GIF en Giphy con una cadena de consulta

   • Entradas:

     • query (cadena): término o frase de consulta de búsqueda

     • limit (número opcional): número máximo de objetos a devolver (predeterminado: 10, máximo: 50)

     • offset (número opcional): desplazamiento de resultados (predeterminado: 0)

     • rating (cadena opcional): Clasificación del contenido (g, pg, pg-13, r)

     • lang (cadena opcional): código de idioma (predeterminado: en)

   • Devuelve: Matriz de objetos GIF con metadatos

2. get_random_gif

   • Obtén un GIF aleatorio de Giphy, opcionalmente filtrado por etiqueta

   • Entradas:

     • tag (cadena opcional): Etiqueta para limitar resultados aleatorios

     • rating (cadena opcional): Clasificación del contenido (g, pg, pg-13, r)

   • Devuelve: objeto GIF aleatorio con metadatos

3. get_trending_gifs

   • Obtén los GIF que son tendencia actualmente en Giphy

   • Entradas:

     • limit (número opcional): número máximo de objetos a devolver (predeterminado: 10, máximo: 50)

     • offset (número opcional): desplazamiento de resultados (predeterminado: 0)

     • rating (cadena opcional): Clasificación del contenido (g, pg, pg-13, r)

   • Devoluciones: Matriz de objetos GIF de tendencia con metadatos

Related MCP server: MCP Video Recognition Server

Formato de respuesta

Cada GIF en la respuesta incluye:

• id : Identificador único de Giphy

• title : Título del GIF

• url : URL del GIF en el sitio web de Giphy

• images : Objeto que contiene varios formatos de imagen, cada uno con:

  • url : URL directa al archivo de imagen

  • width : Ancho de la imagen

  • height : Altura de la imagen

• Metadatos adicionales cuando estén disponibles

Configuración

Instalación mediante herrería

Para instalar mcp-server-giphy para Claude Desktop automáticamente a través de Smithery :

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

Clave API de Giphy

Crear una clave API de Giphy :

• Regístrate para obtener una cuenta de desarrollador de Giphy

• Crea una aplicación para obtener una clave API

• Elija entre el nivel gratuito o las opciones de pago según sus necesidades.

Configuración del entorno

Crea un archivo .env con tu clave API:

GIPHY_API_KEY=your_api_key_here

Uso con Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su claude_desktop_config.json :

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

Desarrollo

# 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

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.