Pinterest APIをAIエージェントとLLMと統合するためのモデルコンテキストプロトコル(MCP)サーバー。

概要

このMCPサーバーは、AIエージェントが標準化された方法でPinterest APIとやり取りし、以下のような機能を可能にします。

• ユーザー情報の取得
• Pinterestボードの管理(リスト、作成、閲覧)
• ピンの管理(リスト、作成、閲覧)

前提条件

• Node.js (v14 または newer)
• Pinterest開発者アカウント
• PinterestのAPI アプリの資格情報

セットアップ

1. このリポジトリをクローンする:

2. 依存関係を取付けて下さい:

3. テンプレートから[.envファイルを作成する:

4。 [.envファイルをPinterest APIの認証情報で編集します。

5. Pinterest Developer Platformでアプリケーションを登録する

• [http://localhost:3052/を認証リダイレクトURIとして追加

使用法

1. MCP サーバーを起動します。

2. 認証トークンが存在しない場合、サーバーは認証のために自動的にブラウザウィンドウを開きます。

3。 認証が成功すると、MCPサーバーはAIエージェントからの接続を受け入れる準備ができています。

#AIエージェントとの接続

MCP サーバは、ソケット上で MCP プロトコルを実行します。 IO および次のツールを公開します。

• [pinterest.user.get_info - ユーザー情報の取得

Pinterest MCP Server

A Model Context Protocol (MCP) server for integrating the Pinterest API with AI agents and LLMs.

Overview

This MCP server allows AI agents to interact with the Pinterest API in a standardized way, enabling functionalities like:

• Retrieving user information
• Managing Pinterest boards (listing, creating, viewing)
• Managing pins (listing, creating, viewing)

Prerequisites

• Node.js (v14 or newer)
• Pinterest Developer Account
• Pinterest API App credentials

Setup

1. Clone this repository:

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

2. Install dependencies:

npm install

3. Create a .env file from the template:

cp .env.template .env

4. Edit the .env file with your Pinterest API credentials:

PINTEREST_APP_ID=your_pinterest_app_id
PINTEREST_APP_SECRET=your_pinterest_app_secret

5. Register your application on the Pinterest Developer Platform
   • Add http://localhost:3052/ as an authorized redirect URI

Usage

1. Start the MCP server:

npm start

2. If no authentication token exists, the server will automatically open a browser window for authentication.

3. After successful authentication, the MCP server will be ready to accept connections from AI agents.

Connecting with AI Agents

The MCP server implements the MCP protocol over Socket.IO and exposes the following tools:

• pinterest.user.get_info - Get user information
• pinterest.boards.list - List user’s boards
• pinterest.boards.create - Create a new board
• pinterest.boards.get - Get board details
• pinterest.pins.list - List pins on a board
• pinterest.pins.create - Create a new pin
• pinterest.pins.get - Get pin details

You can connect your AI agents to this MCP server using compatible MCP client libraries.

Example (Claude.ai Desktop App)

1. Make sure your MCP server is running
2. Open Claude Desktop App
3. Click on “Connect local tools” (bottom right)
4. Enter http://localhost:3052 as the server URL
5. You can now ask Claude to perform Pinterest actions like:
   • “List my Pinterest boards”
   • “Create a new Pinterest board called ‘Vacation Ideas’”
   • “Pin this image to my Travel board”

License

MIT