Skip to main content
Glama

mcp-pinterest

Значок оценки безопасности MseeP.ai

Pinterest MCP-сервер

npm-версияЗагрузки НПМ значок кузнеца Проверено на MseeP

Сервер Model Context Protocol (MCP) для поиска изображений и информации на Pinterest.

Функции

  • Поиск изображений на Pinterest по ключевым словам

  • Получите подробную информацию об изображениях Pinterest

  • Полная интеграция с Cursor IDE через MCP

  • Поддержка режима headless-браузера

  • Ограничение контроля результатов поиска

  • Поиск и загрузка изображений из Pinterest

Предпосылки

Установка

Использование NPX (рекомендуется)

Самый простой способ использовать Pinterest MCP Server — через npx:

npx pinterest-mcp-server

Вы можете настроить сервер с помощью параметров командной строки:

# Specify download directory npx pinterest-mcp-server --downloadDir /path/to/downloads # Specify filename template npx pinterest-mcp-server --filenameTemplate "pinterest_{id}" # Specify both options npx pinterest-mcp-server --downloadDir ./images --filenameTemplate "pinterest_{id}"

Глобальная установка

Чтобы установить пакет глобально и использовать его непосредственно из командной строки:

npm install -g pinterest-mcp-server

После установки вы можете запустить сервер с помощью:

pinterest-mcp-server

С теми же параметрами командной строки, что и у версии NPX:

pinterest-mcp-server --downloadDir /path/to/downloads --filenameTemplate "pinterest_{id}"

Установка через Smithery

Чтобы автоматически установить mcp-pinterest для Claude Desktop через Smithery :

npx -y @smithery/cli install mcp-pinterest --client claude

Ручная установка

  1. Клонируйте этот репозиторий:

    git clone https://github.com/terryso/mcp-pinterest.git pinterest-mcp-server cd pinterest-mcp-server
  2. Установите зависимости:

    npm install
  3. Сборка сервера:

    npm run build
  4. Запускаем сервер:

    npm start

Настройка в качестве сервера MCP в курсоре

  1. Открыть курсор IDE

  2. Перейдите в Настройки (⚙️) > Расширения > MCP.

  3. Нажмите «Добавить сервер».

  4. Введите следующие данные:

    • Имя: Pinterest MCP

    • Тип: Команда

    • Команда: node

    • Аргументы: ["/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. Нажмите «Сохранить».

Альтернатива: использование NPX для настройки курсора

Вы также можете настроить Cursor на использование npx-версии сервера:

  1. Открыть курсор IDE

  2. Перейдите в Настройки (⚙️) > Расширения > MCP.

  3. Нажмите «Добавить сервер».

  4. Введите следующие данные:

    • Имя: Pinterest MCP

    • Тип: Команда

    • Команда: npx

    • Аргументы: ["pinterest-mcp-server"]

  5. Нажмите «Сохранить».

Полный пример конфигурации с переменными среды

Для большей гибкости вы можете настроить сервер с помощью переменных среды в конфигурации Cursor MCP:

"pinterest": { "command": "npx", "env": { "MCP_PINTEREST_DOWNLOAD_DIR": "/Users/xxx/Desktop/Images", "MCP_PINTEREST_FILENAME_TEMPLATE": "pin_{imageId}_{timestamp}.{fileExtension}", "MCP_PINTEREST_PROXY_SERVER": "http://127.0.0.1:7890" }, "args": ["pinterest-mcp-server"] }

Эта конфигурация:

  • Использует npx для запуска сервера

  • Устанавливает пользовательский каталог загрузки на рабочем столе.

  • Использует пользовательский шаблон имени файла с идентификатором изображения и временной меткой.

  • Настраивает прокси-сервер для пользователей в регионах, где Pinterest может быть заблокирован

Добавьте это в файл ~/.cursor/mcp.json или настройте через интерфейс Cursor IDE.

Доступные функции MCP

Сервер предоставляет следующие функции MCP:

  • pinterest_search : Поиск изображений на Pinterest по ключевому слову

    • Параметры:

      • keyword : Поисковый термин (обязательно)

      • limit : количество возвращаемых изображений (по умолчанию: 10)

      • headless : использовать ли режим headless браузера (по умолчанию: true)

  • pinterest_get_image_info : Получите подробную информацию об изображении Pinterest

    • Параметры:

      • image_url : URL-адрес изображения Pinterest (обязательно)

  • pinterest_search_and_download : Поиск и загрузка изображений с Pinterest

    • Параметры:

      • keyword : Поисковый термин (обязательно)

      • limit : количество возвращаемых изображений (по умолчанию: 10)

      • headless : использовать ли режим headless браузера (по умолчанию: true)

Пример использования в курсоре

После настройки вы сможете использовать ��ункции Pinterest MCP непосредственно в чате ИИ Cursor:

Search for robot images on Pinterest

ИИ будет использовать сервер MCP для поиска в Pinterest и отображения результатов.

Пример скриншота

Пример поиска Pinterest

Снимок экрана, показывающий поиск 20 изображений 三上悠亚, все изображения успешно загружены.

Разработка

Структура проекта

  • pinterest-mcp-server.ts : Основной файл сервера

  • dist/pinterest-mcp-server.js : Созданный файл JavaScript для производства

  • package.json : Конфигурация проекта и зависимости

Добавление новых функций

Чтобы добавить новые функции MCP:

  1. Изменить pinterest-mcp-server.ts

  2. Регистрация новых функций с использованием MCP SDK

  3. Реализовать логику функции

  4. Пересобрать с помощью npm run build

Поиск неисправностей

  • Если сервер не запускается, проверьте, не используется ли уже порт.

  • Убедитесь, что все зависимости установлены правильно с помощью npm install

  • Убедитесь, что TypeScript правильно настроен с помощью файла tsconfig.json

  • Если вы столкнулись с ошибками сборки, попробуйте запустить npm install -D typescript @types/node

  • Проверьте сетевое подключение для доступа к Pinterest

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Параметры конфигурации

Параметры командной строки (режим NPX)

При использовании сервера через npx вы можете настроить его с помощью следующих параметров командной строки:

  • --downloadDir : Указывает корневой каталог для загрузки изображений.

    npx pinterest-mcp-server --downloadDir /path/to/downloads
  • --filenameTemplate : Указывает шаблон имени файла для загруженных изображений.

    npx pinterest-mcp-server --filenameTemplate "pin_{imageId}_{timestamp}"
  • --port : указывает порт, который будет прослушивать сервер (по умолчанию: 3000)

    npx pinterest-mcp-server --port 8080
  • --proxyServer : указывает прокси-сервер, используемый для подключения к Pinterest.

    npx pinterest-mcp-server --proxyServer "http://127.0.0.1:7890"

Вы можете комбинировать несколько вариантов:

npx pinterest-mcp-server --downloadDir ./images --filenameTemplate "pinterest_{id}" --port 8080 --proxyServer "http://127.0.0.1:7890"

Переменные среды

Сервер также поддерживает следующие переменные среды для конфигурации:

  • MCP_PINTEREST_DOWNLOAD_DIR : Указывает корневой каталог для загрузки изображений. Если не задано, по умолчанию используется каталог ../downloads относительно скрипта сервера.

  • MCP_PINTEREST_FILENAME_TEMPLATE : Указывает шаблон имени файла для загруженных изображений. Если не задано, по умолчанию используется pinterest_{imageId}.{fileExtension} .

  • MCP_PINTEREST_PROXY_SERVER : Указывает прокси-сервер, который будет использоваться для подключения к Pinterest. Формат должен быть protocol://host:port , например http://127.0.0.1:7890 или socks5://127.0.0.1:1080 .

Эти переменные среды можно задать несколькими способами:

  1. Прямо в вашем терминале (как показано в примерах ниже)

  2. В конфигурации Cursor MCP через поле env (см. Полный пример конфигурации )

  3. В файле .env в корневом каталоге проекта

  4. Через параметры командной строки с npx (как показано в разделе «Параметры командной строки »)

Использование

Настройка каталога загрузки

  1. Использование npx с параметрами командной строки:

npx pinterest-mcp-server --downloadDir /path/to/your/download/directory
  1. Задайте каталог загрузки с помощью переменной среды:

# Linux/macOS export MCP_PINTEREST_DOWNLOAD_DIR=/path/to/your/download/directory npx pinterest-mcp-server # Windows (CMD) set MCP_PINTEREST_DOWNLOAD_DIR=C:\path\to\your\download\directory npx pinterest-mcp-server # Windows (PowerShell) $env:MCP_PINTEREST_DOWNLOAD_DIR="C:\path\to\your\download\directory" npx pinterest-mcp-server
  1. Если переменная окружения не задана, сервер будет использовать каталог загрузки по умолчанию (относительно ../downloads серверного скрипта).

Настройка шаблона имени файла

  1. Использование npx с параметрами командной строки:

npx pinterest-mcp-server --filenameTemplate "pin_{imageId}_{timestamp}.{fileExtension}"
  1. Использование переменной среды:

# Linux/macOS export MCP_PINTEREST_FILENAME_TEMPLATE="pin_{imageId}_{timestamp}.{fileExtension}" npx pinterest-mcp-server # Windows (CMD) set MCP_PINTEREST_FILENAME_TEMPLATE="pin_{imageId}_{timestamp}.{fileExtension}" npx pinterest-mcp-server # Windows (PowerShell) $env:MCP_PINTEREST_FILENAME_TEMPLATE="pin_{imageId}_{timestamp}.{fileExtension}" npx pinterest-mcp-server

Шаблон поддерживает следующие переменные:

  • {imageId} : уникальный идентификатор изображения Pinterest.

  • {fileExtension} : расширение файла (например, jpg, png)

  • {timestamp} : Текущая временная метка UTC в формате ГГГГММДДЧЧММСС

  • {index} : номер индекса при загрузке нескольких изображений (начинается с 1)

Примеры шаблонов:

  • pinterest_{imageId}.{fileExtension} (по умолчанию)

  • pin_{timestamp}_{imageId}.{fileExtension}

  • pinterest_image_{index}_{imageId}.{fileExtension}

  • {timestamp}_pinterest.{fileExtension}

Если шаблон недействителен (например, содержит неподдерживаемые переменные или имеет несоответствующие скобки), сервер выведет предупреждение и будет использовать шаблон по умолчанию.

Настройка прокси-сервера

Если вам необходимо использовать прокси-сервер для доступа к Pinterest (особенно в регионах, где Pinterest может быть ограничен), вы можете настроить конфигурацию прокси-сервера:

  1. Использование npx с параметрами командной строки:

npx pinterest-mcp-server --proxyServer "http://127.0.0.1:7890"
  1. Использование переменной среды:

# Linux/macOS export MCP_PINTEREST_PROXY_SERVER="http://127.0.0.1:7890" npx pinterest-mcp-server # Windows (CMD) set MCP_PINTEREST_PROXY_SERVER=http://127.0.0.1:7890 npx pinterest-mcp-server # Windows (PowerShell) $env:MCP_PINTEREST_PROXY_SERVER="http://127.0.0.1:7890" npx pinterest-mcp-server

Поддерживаемые прокси-протоколы:

  • HTTP: http://host:port

  • HTTPS: https://host:port

  • SOCKS4: socks4://host:port

  • SOCKS5: socks5://host:port

Конфигурация прокси-сервера влияет как на браузер, используемый для поиска, так и на процесс загрузки изображений.

Примечания

  • При запуске сервер проверит существование и возможность записи в каталог загрузки. Если каталог не существует, он попытается его создать; если его невозможно создать или записать в него, сервер завершит работу.

  • Клиентам не следует указывать пути загрузки или шаблоны имен файлов через параметры при вызове инструментов, связанных с загрузкой, поскольку все загрузки будут использовать конфигурацию переменных среды сервера или значения по умолчанию.

  • Сервер автоматически очищает имена файлов, заменяя недопустимые символы (такие как / , \ , : , * , ? , " , < , > , | ) на подчеркивания.

Описание интерфейса

Сервер предоставляет следующие инструменты MCP:

  1. pinterest_search : Поиск изображений Pinterest по ключевому слову

  2. pinterest_get_image_info : Получите подробную информацию об изображении Pinterest

  3. pinterest_search_and_download : Поиск и загрузка изображений Pinterest

Подробные справочные данные по параметрам интерфейса см. в определениях инструмента MCP.

Related MCP Servers

  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol (MCP) server that provides search and crawl functionality using Search1API.
    Last updated -
    91
    157
    MIT License
    • Apple
  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol (MCP) server that provides tools for searching and fetching information from Hacker News.
    Last updated -
    4
    53
    MIT License
    • Apple
  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.
    Last updated -
    506
    MIT License
    • Apple
  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol server that enables searching for images on Pixabay with query parameters and returns formatted results with image URLs and metadata.
    Last updated -
    1
    23
    4
    MIT License
    • Apple
    • Linux

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/terryso/mcp-pinterest'

If you have feedback or need assistance with the MCP directory API, please join our Discord server