Mcp Pinterest

Pinterest MCP サーバー

Pinterest の画像検索と情報取得のための Model Context Protocol（MCP）サーバーです。

機能

• キーワードで Pinterest の画像を検索
• Pinterest の画像に関する詳細情報を取得
• MCP を通じて Cursor IDE とシームレスに連携
• ヘッドレスブラウザモードに対応
• 検索結果数を制限
• Pinterest の画像を検索してダウンロード

前提条件

• Node.js（v18 以上）
• MCP 連携用の Cursor IDE

インストール

NPX を使用（推奨）

Pinterest MCP Server を使用する最も簡単な方法は、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 経由でインストール

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
   

3. サーバーをビルドします。

   npm run build
   

4. サーバーを実行します。

   npm start
   

Cursor で MCP サーバーとして設定する

1. Cursor IDE を開きます

2. Settings（⚙️）> Extensions > MCP に移動します

3. 「Add Server」をクリックします

4. 以下の詳細を入力します。

   • Name：Pinterest MCP
   • Type：Command
   • Command：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"]
   }
   

5. 「Save」をクリックします

別の方法：Cursor の設定に NPX を使用する

サーバーの npx 版を使用するよう Cursor を設定することもできます。

1. Cursor IDE を開きます
2. Settings（⚙️）> Extensions > MCP に移動します
3. 「Add Server」をクリックします
4. 以下の詳細を入力します。
   • Name：Pinterest MCP
   • Type：Command
   • Command：npx
   • Args：["pinterest-mcp-server"]
5. 「Save」をクリックします

環境変数を使った設定の完全な例

柔軟性を最大限に高めるには、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 の機能を直接使用できます。

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 ですべての依存関係が正しくインストールされていることを確認してください
• tsconfig.json ファイルで TypeScript が正しく設定されていることを確認してください
• ビルドエラーが発生した場合は、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

2. 環境変数を使用してダウンロードディレクトリを設定します。

# 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

3. 環境変数が設定されていない場合、サーバーはデフォルトのダウンロードディレクトリ（サーバースクリプトからの相対パスである ../downloads）を使用します。

ファイル名テンプレートの設定

1. コマンドラインオプションを指定して npx を使用する場合：

npx pinterest-mcp-server --filenameTemplate "pin_{imageId}_{timestamp}.{fileExtension}"

2. 環境変数を使用する場合：

# 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"

2. 環境変数を使用する場合：

# 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 ツールの定義を参照してください。

⭐ スターの履歴