金大哥 - Pinterest MCP 详情

article

README

🚀 Pinterest MCP 服务器

一个用于Pinterest图片搜索和信息检索的Model Context Protocol (MCP) 服务器，能让你轻松在Pinterest上进行图片搜索与信息获取，还可与Cursor IDE无缝集成。

🚀 快速开始

Pinterest MCP服务器可助力你在Pinterest上开展图片搜索与信息检索工作。下面为你介绍使用前的准备工作。

✨ 主要特性

🔍 根据关键词搜索Pinterest上的图片
📋 获取Pinterest图片的详细信息
💻 通过MCP与Cursor IDE无缝集成
🕸️ 支持无头浏览器模式
📊 控制搜索结果的数量限制
💾 搜索并下载Pinterest上的图片

📦 安装指南

先决条件

Node.js（v18或更高版本）
Cursor IDE 用于MCP集成

安装方式

使用Smithery自动安装

要通过Smithery为Claude Desktop自动安装mcp - pinterest，可执行以下命令：

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

手动安装

克隆此仓库：

git clone https://github.com/terryso/mcp-pinterest.git pinterest-mcp-server
cd pinterest-mcp-server

安装依赖项：

npm install

💻 使用示例

命令模式（推荐）

构建服务器：

npm run build

现在，您可以在Cursor中将此服务器作为MCP服务器使用。

配置到Cursor IDE

打开Cursor IDE。
访问工具 > MCP 服务器管理器。
点击 添加新服务器。
填写以下信息：
- 名称: Pinterest
- 类型: Node.js
- 路径: 指向构建后的服务器文件夹（pinterest-mcp-server/dist）。
完成后，启动服务器并在工具中使用它。

基础用法

搜索图片

# 搜索关键词为 "flowers" 的图片，默认返回20条结果
pinterest_search keyword=flowers

获取图片信息

# 获取指定图片URL的详细信息
pinterest_get_image_info url=https://example.com/pinterest-image.jpg

搜索并下载图片

# 搜索关键词为 "animals" 的图片并下载到默认目录
pinterest_search_and_download keyword=animals

高级用法

搜索图片并指定结果数量

# 搜索关键词为 "cars" 的图片，返回10条结果
pinterest_search keyword=cars limit=10

搜索并下载图片到指定目录

# 搜索关键词为 "nature" 的图片并下载到指定目录
pinterest_search_and_download keyword=nature download_dir=./my-downloads

📚 详细文档

可用的MCP函数

pinterest_search

描述：根据关键词搜索Pinterest图片。
参数：
- keyword：要搜索的关键词（必填）。
- limit (可选)：返回的结果数量，默认为20。
返回值：搜索结果列表，包含图片URL和相关元数据。

pinterest_get_image_info

描述：获取指定Pinterest图片的详细信息。
参数：
- url：图片的完整URL（必填）。
返回值：包含图片ID、尺寸、作者信息和其他元数据的详细对象。

pinterest_search_and_download

描述：搜索并下载Pinterest图片到指定目录。
参数：
- keyword：要搜索的关键词（必填）。
- download_dir (可选)：下载文件夹路径，默认为./downloads。
返回值：成功下载的文件路径列表。

🔧 技术细节

该服务器基于Node.js构建，通过MCP协议与Cursor IDE集成。它利用无头浏览器模式来模拟用户在Pinterest上的操作，支持对搜索结果数量的控制，确保能高效准确地进行图片搜索和信息检索。

📄 许可证

文档未提及许可证相关信息，故此处不展示。

⚠️ 重要提示

请勿在调用下载相关工具时通过参数指定下载路径，所有下载文件将保存到环境变量或默认目录中。

Pinterest