Pinterest MCP Server

Features

• Search for images on Pinterest by keywords

• Retrieve detailed information about Pinterest images

• Seamless integration with Cursor IDE through MCP

• Support for headless browser mode

• Limit control for search results

Prerequisites

• [Node.js](https://nodejs.org/) (v18 or higher)

• [Cursor IDE](https://cursor.sh/) for MCP integration

Installation

Installing via Smithery

Manual

1. Clone this repository: ```bash git clone https://github.com/terryso/mcp-pinterest.git pinterest-mcp-server cd pinterest-mcp-server ```

2. Install dependencies: ```bash npm install ```

Usage

Command Mode (Recommended)

Configuring as MCP Server in Cursor

1. Open Cursor IDE

2. Go to Settings ( ) > Extensions > MCP

3. Click "Add Server"

4. Enter the following details: - Name: Pinterest MCP - Type: Command - Command: `node` - Args: `["/path/to/mcp-pinterest/dist/pinterest-mcp-server.js"]` Cursor MCP `~/.cursor/mcp.json` ```json "pinterest": { "command": "node", "args": ["/path/to/mcp-pinterest/dist/pinterest-mcp-server.js"] } ```

5. Click "Save"

Available MCP Functions

• `pinterest_search`: Search for images on Pinterest by keyword - Parameters: - `keyword`: Search term (required) - `limit`: Number of images to return (default: 10) - `headless`: Whether to use headless browser mode (default: true)

• `pinterest_get_image_info`: Get detailed information about a Pinterest image - Parameters: - `image_url`: URL of the Pinterest image (required)

Example Usage in Cursor

Example Screenshot

Development

Project Structure

• `pinterest-mcp-server.ts`: Main server file

• `dist/pinterest-mcp-server.js`: Built JavaScript file for production

• `package.json`: Project configuration and dependencies

Adding New Features

1. Modify `pinterest-mcp-server.ts`

2. Register new functions using the MCP SDK

3. Implement the function logic

4. Rebuild with `npm run build`

Troubleshooting

• If the server fails to start, check if the port is already in use

• Ensure all dependencies are correctly installed with `npm install`

• Make sure TypeScript is properly configured with a `tsconfig.json` file

• If you encounter build errors, try running `npm install -D typescript @types/node`

• Verify network connectivity for Pinterest access

License