星战科技xingzhan.cloud
返回市场
麦普兴趣流

麦普兴趣流

作者：terryso19 星标更新：2025-07-02
安装使用来源：spider==github.com

项目介绍

MseeP.ai 安全评估徽章

Pinterest MCP 服务器

npm 版本 NPM 下载量 smithery 徽章 在 MseeP 上验证

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

功能

  • 通过关键词搜索 Pinterest 图片
  • 获取 Pinterest 图片的详细信息
  • 通过 MCP 无缝集成到 Cursor IDE
  • 支持无头浏览器模式
  • 搜索结果数量控制
  • 从 Pinterest 搜索并下载图片

预备条件

安装

使用 NPX（推荐）

使用 Pinterest MCP 服务器最简单的方法是通过 npx：

npx pinterest-mcp-server

你可以通过命令行选项来配置服务器：

# 指定下载目录
npx pinterest-mcp-server --downloadDir /path/to/downloads

# 指定文件名模板
npx pinterest-mcp-server --filenameTemplate "pinterest_{id}"

# 同时指定两个选项
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 安装

要自动通过 Smithery 安装 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

  2. 安装依赖项：

    npm install

  3. 构建服务器：

    npm run build

  4. 运行服务器：

    npm start

在 Cursor 中配置为 MCP 服务器

  1. 打开 Cursor 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

你也可以配置 Cursor 使用 npx 版本的服务器：

  1. 打开 Cursor 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 运行服务器
  • 设置桌面上的自定义下载目录
  • 使用带有图片 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 中的示例用法

配置完成后，你可以在 Cursor 的 AI 聊天中直接使用 Pinterest MCP 函数：

搜索 Pinterest 上的机器人图片

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

示例截图

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 图片的唯一 ID
  • {fileExtension}：文件扩展名（例如 jpg、png）
  • {timestamp}：当前 UTC 时间戳，格式为 YYYYMMDDHHMMSS
  • {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 工具定义。

⭐ 星标历史

星标历史图表