Pinterest MCP 服务器

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

功能

• 通过关键词在 Pinterest 上搜索图片
• 检索 Pinterest 图片的详细信息
• 通过 MCP 与 Cursor IDE 无缝集成
• 支持无头浏览器模式
• 搜索结果数量控制

前提条件

• Node.js (v18 或更高版本)
• Cursor IDE 用于 MCP 集成

安装

通过 Smithery 安装

要通过 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
   

2. 安装依赖项：

   npm install
   

用法

命令行模式 (推荐)

构建服务器：

npm run build

现在你可以将此服务器用作 Cursor 中的 MCP 服务器。

在 Cursor 中配置为 MCP 服务器

1. 打开 Cursor IDE
2. 转到 Settings (⚙️) > Extensions > MCP
3. 点击 "Add Server"
4. 输入以下详细信息：
   • Name: Pinterest MCP
   • TYPE: COMMAND
   • COMMAND: node /path/to/mcp-pinterest/dist/pinterest-mcp-server.js
5. 点击 "Save"

可用的 MCP 函数

服务器公开以下 MCP 函数：

• pinterest_search: 通过关键词在 Pinterest 上搜索图片

  • 参数：
    • keyword: 搜索词 (必需)
    • limit: 返回的图片数量 (默认: 10)
    • headless: 是否使用无头浏览器模式 (默认: true)

• pinterest_get_image_info: 获取 Pinterest 图片的详细信息

  • 参数：
    • image_url: Pinterest 图片的 URL (必需)

在 Cursor 中的示例用法

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

Search for robot images on Pinterest

AI 将使用 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 文件。