Pinterest MCP

](https://mseep.ai/app/terryso-mcp-pinterest)

Pinterest MCP服务器

](https://badge.fury.io/js/pinterest-mcp-server)

](https://smithery.ai/server/@terryso/mcp-pinterest) 

用于Pinterest图像搜索和信息检索的模型上下文协议（MCP）服务器。

特性

• 按关键字在Pinterest上搜索图片
• 检索有关Pinterest图片的详细信息
• 通过MCP与Cursor IDE无缝集成
• 支持无头浏览器模式
• 限制搜索结果的控制
• 从Pinterest搜索和下载图片

先决条件

• （v18或更高版本）
• 光标IDE 用于MCP集成

安装

使用NPX（推荐）

使用Pinterest MCP服务器的最简单方法是通过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安装

通过以下方式自动安装Claude Desktop的mcp pinterest 史密瑟里:

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

1. 安装依赖项：

   npm install

1. 构建服务器：

   npm run build

1. 运行服务器：

   npm start

在游标中配置为MCP服务器

1. 打开光标IDE

1. 转到设置(⚙️) > 扩展>MCP

1. 点击“添加服务器”

1. 输入以下详细信息：

- 名称：Pinterest MCP - 类型：命令 - 命令： node - Args： ["/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"]
   }

1. 点击“保存”

替代方案：使用NPX进行光标配置

您还可以将Cursor配置为使用npx版本的服务器：

1. 打开光标IDE
2. 转到设置(⚙️) > 扩展>MCP
3. 点击“添加服务器”
4. 输入以下详细信息：

- 名称：Pinterest MCP - 类型：命令 - 命令： npx - Args： ["pinterest-mcp-server"]

1. 点击“保存”

带有环境变量的完整配置示例

为了获得最大的灵活性，您可以在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运行服务器
• 在桌面上设置自定义下载目录
• 使用具有图像ID和时间戳的自定义文件名模板
• 为Pinterest可能被阻止的地区的用户配置代理服务器

将此添加到您的 ~/.cursor/mcp.json 文件或通过Cursor IDE界面设置。

可用的MCP功能

服务器公开以下MCP功能：

• pinterest_search：按关键字搜索Pinterest上的图片

- 参数： - keyword：搜索词（必填） - limit：要返回的图像数量（默认值：10） - headless：是否使用无头浏览器模式（默认值：true）

• pinterest_get_image_info：获取有关Pinterest图片的详细信息

- 参数： - image_url：Pinterest图片的URL（必填）

• pinterest_search_and_download：从Pinterest搜索和下载图片

- 参数： - keyword：搜索词（必填） - limit：要返回的图像数量（默认值：10） - headless：是否使用无头浏览器模式（默认值：true）

游标用法示例

配置后，您可以直接在Cursor的AI聊天中使用Pinterest MCP功能：

Search for robot images on Pinterest

AI将使用MCP服务器搜索Pinterest并显示结果。

示例屏幕截图

Pinterest Search Example

*屏幕截图显示搜索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许可证获得许可-请参阅 许可证 文件以获取详细信息。

配置选项

命令行选项（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图片的唯一ID
• {fileExtension}：文件扩展名（例如jpg、png）
• {timestamp}：YYYYMMDDHHMMSS格式的当前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
• 袜子4： socks4://host:port
• 袜子5： socks5://host:port

代理配置会影响用于搜索的浏览器和图像下载过程。

备注

• 启动时，服务器将验证下载目录的存在性和可写性。如果目录不存在，它将尝试创建它；如果无法创建或写入，服务器将退出。
• 客户端在调用下载相关工具时不应通过参数指定下载路径或文件名模板，因为所有下载都将使用服务器的环境变量配置或默认值。
• 服务器通过替换非法字符（如 /, \, :, *, ?, ", `, |`)带下划线。

接口描述

服务器提供以下MCP工具：

1. pinterest_search：按关键字搜索Pinterest图片
2. pinterest_get_image_info：获取有关Pinterest图片的详细信息
3. pinterest_search_and_download：搜索和下载Pinterest图片

有关详细的接口参数参考，请参阅MCP工具定义。

⭐ 明星历史