Servidor MCP Giphy

insignia de herrería versión npm Descargas de npm Licencia: MIT

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

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
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
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.

MCP Server Giphy