Pinterest MCP-сервер

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

Функции

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

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

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

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

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

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

Related MCP server: FGCLIP-MCP

Предпосылки

• Node.js (v18 или выше)

• Cursor IDE для интеграции MCP

Установка

Использование 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

2. Задайте каталог загрузки с помощью переменной среды:

# 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

3. Если переменная окружения не задана, сервер будет использовать каталог загрузки по умолчанию (относительно ../downloads серверного скрипта).

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

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

npx pinterest-mcp-server --filenameTemplate "pin_{imageId}_{timestamp}.{fileExtension}"

2. Использование переменной среды:

# 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"

2. Использование переменной среды:

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