Skip to main content
Glama
Sign In
deenesjakoruzh

mcp-pinterest

by terryso
npmGitHub
TypeScript
MIT License
91
10
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Allows searching for images on Pinterest by keywords and retrieving detailed information about Pinterest images

Pinterest MCP-сервер

Сервер 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 и отображения результатов.

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

Снимок экрана, показывающий поиск 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.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

  1. Функции
    1. Предпосылки
      1. Установка
        1. Использование NPX (рекомендуется)
        2. Глобальная установка
        3. Установка через Smithery
        4. Ручная установка
      2. Настройка в качестве сервера MCP в курсоре
        1. Альтернатива: использование NPX для настройки курсора
        2. Полный пример конфигурации с переменными среды
      3. Доступные функции MCP
        1. Пример использования в курсоре
          1. Пример скриншота
        2. Разработка
          1. Структура проекта
          2. Добавление новых функций
        3. Поиск неисправностей
          1. Лицензия
            1. Параметры конфигурации
              1. Параметры командной строки (режим NPX)
              2. Переменные среды
              3. Использование

            Related Resources

            Related MCP Servers

            • @kazuph/mcp-fetch

              kazuph
              A
              security
              A
              license
              A
              quality
              Model Context Protocol server for fetching web content and processing images. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.
              Last updated -
              1
              278
              15
              JavaScript
              MIT License
              • Apple

            • Smart Photo Journal MCP Server

              Siddhant-K-code
              A
              security
              A
              license
              A
              quality
              This MCP server aids users in searching and analyzing their photo library by location, labels, and people, offering functionalities like photo analysis and fuzzy matching for enhanced photo management.
              Last updated -
              14
              Python
              MIT License
              • Apple

            • DuckDuckGo MCP Server

              nickclyde
              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 -
              2
              26
              Python
              MIT License
              • Apple

            • URL Fetch MCP

              aelaguiz
              -
              security
              A
              license
              -
              quality
              A Model Context Protocol (MCP) server that enables Claude or other LLMs to fetch content from URLs, supporting HTML, JSON, text, and images with configurable request parameters.
              Last updated -
              Python
              MIT License

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            ID: 9czyga0hyf