mcp-pinterest

Pinterest MCP-сервер

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

Функции

• Поиск изображений на Pinterest по ключевым словам
• Получите подробную информацию об изображениях Pinterest
• Полная интеграция с Cursor IDE через MCP
• Поддержка режима headless-браузера
• Ограничение контроля результатов поиска
• Поиск и загрузка изображений из Pinterest

Предпосылки

• Node.js (v18 или выше)
• Cursor IDE для интеграции MCP

Установка

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

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

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

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

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

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

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

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

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

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

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:

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

• Использует 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:

ИИ будет использовать сервер 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"

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

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

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

• 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 с параметрами командной строки:

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

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

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

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

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

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

• {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 с параметрами командной строки:

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

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

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