mcp-pinterest

Pinterest MCP 서버

Pinterest 이미지 검색 및 정보 수집을 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

• 키워드로 Pinterest에서 이미지 검색
• Pinterest 이미지에 대한 자세한 정보를 검색합니다
• MCP를 통한 Cursor IDE와의 원활한 통합
• 헤드리스 브라우저 모드 지원
• 검색 결과에 대한 제어 제한
• Pinterest에서 이미지 검색 및 다운로드

필수 조건

• Node.js (v18 이상)
• MCP 통합을 위한 커서 IDE

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-pinterest를 자동으로 설치하려면:

지엑스피1

수동

1. 이 저장소를 복제하세요:
   git clone https://github.com/terryso/mcp-pinterest.git pinterest-mcp-server cd pinterest-mcp-server
2. 종속성 설치:
   npm install

용법

명령 모드(권장)

서버를 빌드하세요:

이제 이 서버를 Cursor의 MCP 서버로 사용할 수 있습니다.

커서에서 MCP 서버로 구성

1. 커서 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. "저장"을 클릭하세요

사용 가능한 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의 AI 채팅에서 Pinterest MCP 기능을 직접 사용할 수 있습니다.

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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

구성 옵션

환경 변수

서버는 구성을 위해 다음과 같은 환경 변수를 지원합니다.

• 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. 환경 변수가 설정되지 않으면 서버는 기본 다운로드 디렉토리(서버 스크립트의 ../downloads 를 기준으로 함)를 사용합니다.

파일 이름 템플릿 설정

MCP_PINTEREST_FILENAME_TEMPLATE 환경 변수를 사용하여 다운로드한 이미지의 파일 이름 패턴을 사용자 지정할 수 있습니다.

템플릿은 다음 변수를 지원합니다.

• {imageId} : Pinterest 이미지의 고유 ID
• {fileExtension} : 파일 확장자(예: jpg, png)
• {timestamp} : YYYYMMDDHHMMSS 형식의 현재 UTC 타임스탬프
• {index} : 여러 이미지를 다운로드할 때의 인덱스 번호(1부터 시작)

예시 템플릿:

• pinterest_{imageId}.{fileExtension} (기본값)
• pin_{timestamp}_{imageId}.{fileExtension}
• pinterest_image_{index}_{imageId}.{fileExtension}
• {timestamp}_pinterest.{fileExtension}

템플릿이 유효하지 않은 경우(예: 지원되지 않는 변수가 포함되어 있거나 괄호가 일치하지 않는 경우) 서버는 경고를 기록하고 기본 템플릿을 사용합니다.

프록시 서버 설정

Pinterest에 접속하기 위해 프록시를 사용해야 하는 경우(특히 Pinterest가 제한될 수 있는 지역에서) 다음과 같이 프록시 구성을 설정할 수 있습니다.

지원되는 프록시 프로토콜:

• 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 도구 정의를 참조하세요.