mcp-pinterest

Servidor MCP de Pinterest

Un servidor de Protocolo de Contexto Modelo (MCP) para la búsqueda de imágenes y la recuperación de información en Pinterest.

Características

• Buscar imágenes en Pinterest por palabras clave
• Recuperar información detallada sobre las imágenes de Pinterest
• Integración perfecta con Cursor IDE a través de MCP
• Compatibilidad con el modo de navegador sin cabeza
• Control de límites para los resultados de búsqueda
• Busca y descarga imágenes de Pinterest

Prerrequisitos

• Node.js (v18 o superior)
• IDE de Cursor para la integración de MCP

Instalación

Instalación mediante herrería

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

Manual

1. Clonar este repositorio:
   git clone https://github.com/terryso/mcp-pinterest.git pinterest-mcp-server cd pinterest-mcp-server
2. Instalar dependencias:
   npm install

Uso

Modo de comando (recomendado)

Construir el servidor:

Ahora puedes usar este servidor como servidor MCP en Cursor.

Configuración como servidor MCP en Cursor

1. Abrir cursor IDE
2. Vaya a Configuración (⚙️) > Extensiones > MCP
3. Haga clic en "Agregar servidor"
4. Introduzca los siguientes datos:
   • Nombre: Pinterest MCP
   • Tipo: Comando
   • Comando: node
   • Argumentos: ["/path/to/mcp-pinterest/dist/pinterest-mcp-server.js"]

   或者直接编辑Cursor的MCP配置文件（通常位于~/.cursor/mcp.json ），添加以下内容：

   "pinterest": { "command": "node", "args": ["/path/to/mcp-pinterest/dist/pinterest-mcp-server.js"] }
5. Haga clic en "Guardar"

Funciones MCP disponibles

El servidor expone las siguientes funciones MCP:

• pinterest_search : busca imágenes en Pinterest por palabra clave
  • Parámetros:
    • keyword : término de búsqueda (obligatorio)
    • limit : Número de imágenes a devolver (predeterminado: 10)
    • headless : si se debe utilizar el modo de navegador sin cabeza (valor predeterminado: verdadero)
• pinterest_get_image_info : Obtenga información detallada sobre una imagen de Pinterest
  • Parámetros:
    • image_url : URL de la imagen de Pinterest (obligatorio)
• pinterest_search_and_download : Busca y descarga imágenes de Pinterest
  • Parámetros:
    • keyword : término de búsqueda (obligatorio)
    • limit : Número de imágenes a devolver (predeterminado: 10)
    • headless : si se debe utilizar el modo de navegador sin cabeza (valor predeterminado: verdadero)

Ejemplo de uso en Cursor

Una vez configurado, puedes usar las funciones de Pinterest MCP directamente en el chat de IA de Cursor:

La IA utilizará el servidor MCP para buscar en Pinterest y mostrar los resultados.

Ejemplo de captura de pantalla

Captura de pantalla que muestra una búsqueda de 20 imágenes de 三上悠亚 con todas las imágenes descargadas correctamente.

Desarrollo

Estructura del proyecto

• pinterest-mcp-server.ts : Archivo del servidor principal
• dist/pinterest-mcp-server.js : Archivo JavaScript creado para producción
• package.json : Configuración del proyecto y dependencias

Añadiendo nuevas funciones

Para agregar nuevas funciones MCP:

1. Modificar pinterest-mcp-server.ts
2. Registrar nuevas funciones utilizando el SDK de MCP
3. Implementar la lógica de la función
4. Reconstruir con npm run build

Solución de problemas

• Si el servidor no se inicia, verifique si el puerto ya está en uso
• Asegúrese de que todas las dependencias estén instaladas correctamente con npm install
• Asegúrese de que TypeScript esté configurado correctamente con un archivo tsconfig.json
• Si encuentra errores de compilación, intente ejecutar npm install -D typescript @types/node
• Verificar la conectividad de red para acceder a Pinterest

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Opciones de configuración

Variables de entorno

El servidor admite las siguientes variables de entorno para la configuración:

• MCP_PINTEREST_DOWNLOAD_DIR : Especifica el directorio raíz para descargar imágenes. Si no se configura, el valor predeterminado es el directorio ../downloads correspondiente al script del servidor.
• MCP_PINTEREST_FILENAME_TEMPLATE : Especifica la plantilla de nombre de archivo para las imágenes descargadas. Si no se configura, el valor predeterminado es pinterest_{imageId}.{fileExtension} .
• MCP_PINTEREST_PROXY_SERVER : Especifica el servidor proxy que se usará para conectarse a Pinterest. El formato debe ser protocol://host:port , por ejemplo, http://127.0.0.1:7890 o socks5://127.0.0.1:1080 .

Uso

Configuración del directorio de descarga

1. Establezca el directorio de descarga mediante una variable de entorno (método recomendado):

2. Si la variable de entorno no está configurada, el servidor utilizará el directorio de descarga predeterminado (relativo al ../downloads del script del servidor).

Configuración de la plantilla de nombre de archivo

Puede personalizar el patrón del nombre de archivo para las imágenes descargadas utilizando la variable de entorno MCP_PINTEREST_FILENAME_TEMPLATE :

La plantilla admite las siguientes variables:

• {imageId} : El ID único de la imagen de Pinterest
• {fileExtension} : La extensión del archivo (por ejemplo, jpg, png)
• {timestamp} : Marca de tiempo UTC actual en formato AAAAMMDDHHMMSS
• {index} : El número de índice al descargar varias imágenes (comienza desde 1)

Plantillas de ejemplo:

• pinterest_{imageId}.{fileExtension} (predeterminado)
• pin_{timestamp}_{imageId}.{fileExtension}
• pinterest_image_{index}_{imageId}.{fileExtension}
• {timestamp}_pinterest.{fileExtension}

Si la plantilla no es válida (por ejemplo, contiene variables no admitidas o tiene corchetes no coincidentes), el servidor registrará una advertencia y utilizará la plantilla predeterminada.

Configuración del servidor proxy

Si necesita utilizar un proxy para acceder a Pinterest (especialmente en regiones donde Pinterest podría estar restringido), puede establecer la configuración del proxy:

Protocolos proxy compatibles:

• HTTP: http://host:port
• HTTPS: https://host:port
• CALCETINES4: socks4://host:port
• CALCETINES5: socks5://host:port

La configuración del proxy afecta tanto al navegador utilizado para la búsqueda como al proceso de descarga de imágenes.

Notas

• El servidor verificará la existencia y la escritura en el directorio de descarga al iniciarse. Si el directorio no existe, intentará crearlo; si no se puede crear ni escribir en él, el servidor cerrará.
• Los clientes no deben especificar rutas de descarga o plantillas de nombres de archivos a través de parámetros al llamar a herramientas relacionadas con la descarga, ya que todas las descargas utilizarán la configuración o los valores predeterminados de la variable de entorno del servidor.
• El servidor desinfecta automáticamente los nombres de archivos reemplazando caracteres ilegales (como / , \ , : , * , ? , " , < , > , | ) con guiones bajos.

Descripción de la interfaz

El servidor proporciona las siguientes herramientas MCP:

1. pinterest_search : busca imágenes de Pinterest por palabra clave
2. pinterest_get_image_info : Obtenga información detallada sobre una imagen de Pinterest
3. pinterest_search_and_download : Busca y descarga imágenes de Pinterest

Para obtener referencias detalladas de los parámetros de la interfaz, consulte las definiciones de la herramienta MCP.