MCPollinations 멀티모달 MCP 서버

Pollinations API를 통해 AI 어시스턴트가 이미지, 텍스트 및 오디오를 생성할 수 있도록 하는 MCP(Model Context Protocol) 서버

특징

텍스트 프롬프트에서 이미지 URL 생성
이미지를 생성하고 이를 base64로 인코딩된 데이터로 반환하고 png, jpeg, jpg 또는 webp로 저장합니다(기본값: png)
텍스트 프롬프트에서 텍스트 응답 생성
텍스트 프롬프트에서 오디오 응답 생성
사용 가능한 이미지 및 텍스트 생성 모델 나열
인증이 필요하지 않습니다
간단하고 가볍습니다
모델 컨텍스트 프로토콜(MCP)과 호환

시스템 요구 사항

Node.js : 버전 14.0.0 이상
- 최상의 성능을 위해 Node.js 16.0.0 이상을 권장합니다.
- Node.js 버전 16 이하에서는 AbortController 폴리필을 사용합니다.

빠른 시작

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 mcpollinations를 자동으로 설치하려면:

지엑스피1

MCP 서버를 사용하는 가장 쉬운 방법:

# Run directly with npx (no installation required)
npx @pinkpixel/mcpollinations

글로벌하게 설치하려면 다음을 수행하세요.

# Install globally
npm install -g @pinkpixel/mcpollinations

# Run the server
mcpollinations
# or
npx @pinkpixel/mcpollinations

또는 저장소를 복제합니다.

# Clone the git repository
git clone https://github.com/pinkpixel-dev/mcpollinations.git
# Run the server
mcpollinations
# or
npx @pinkpixel/mcpollinations
# or run directly
node /path/to/MCPollinations/pollinations-mcp-server.js

MCP 통합

MCP(모델 컨텍스트 프로토콜)를 지원하는 애플리케이션과 서버를 통합하려면 다음을 수행합니다.

MCP 구성 파일을 생성합니다.

# If installed globally
npx @pinkpixel/mcpollinations generate-config

# Or run directly
node /path/to/MCPollinations/generate-mcp-config.js

안내에 따라 구성을 사용자 지정하거나 기본값을 사용하세요.
- 사용자 정의 출력 및 임시 디렉토리 설정(이식성을 위해 상대 경로가 기본값임)
- 이미지 생성을 위한 기본 매개변수를 구성합니다(사용 가능한 모델, 치수 등의 목록 포함)
- 텍스트 생성을 위한 기본 매개변수 구성(사용 가능한 모델 목록 포함)
- 오디오 생성(음성)을 위한 기본 매개변수 구성
- 어떤 도구를 허용해야 하는지 지정하세요
생성된 mcp.json 파일을 애플리케이션의 MCP 설정 .json 파일에 복사합니다.
애플리케이션을 다시 시작하세요.

통합 후에는 다음과 같은 명령을 사용할 수 있습니다.

"MCPollinations를 사용하여 바다 위의 일몰 이미지 생성"

문제 해결

"AbortController가 정의되지 않았습니다" 오류

MCP 서버를 실행할 때 이 오류가 발생하는 경우:

ReferenceError: AbortController is not defined

이 문제는 일반적으로 이전 버전의 Node.js(16.0.0 미만)에서 실행될 때 발생합니다. 다음 해결 방법 중 하나를 시도해 보세요.

Node.js 업데이트 (권장):
- Node.js 16.0.0 이상으로 업데이트하세요
글로벌 설치 사용
- 패키지의 최신 버전으로 업데이트: GXP7
AbortController를 수동으로 설치하세요 :
- 어떤 이유로 폴리필이 작동하지 않는 경우: GXP8

Node.js 버전 확인

현재 Node.js 버전을 확인하려면:

node --version

16.0.0보다 낮은 버전이 표시되면 최상의 호환성을 위해 업그레이드하는 것을 고려하세요.

사용 가능한 도구

MCP 서버는 다음과 같은 도구를 제공합니다.

generateImageUrl - 텍스트 프롬프트에서 이미지 URL을 생성합니다.
generateImage - 이미지를 생성하고, 이를 base64로 인코딩된 데이터로 반환하고, 기본적으로 파일(PNG 형식)로 저장합니다.
respondAudio - 텍스트 프롬프트에 대한 오디오 응답을 생성합니다(사용자 정의 가능한 음성 매개변수)
respondText - 텍스트 모델을 사용하여 프롬프트에 텍스트로 응답합니다(사용자 정의 가능한 모델 매개변수)
listImageModels - 이미지 생성에 사용 가능한 모델을 나열합니다.
listTextModels - 텍스트 생성에 사용 가능한 모델을 나열합니다.
listAudioVoices - 오디오 생성에 사용 가능한 모든 음성을 나열합니다.

이미지 생성 세부 정보

기본 동작

generateImage 도구를 사용할 때:

이미지는 기본적으로 PNG 파일로 디스크에 저장됩니다.
기본 저장 위치는 MCP 서버가 실행 중인 현재 작업 디렉토리입니다.
기본적으로 '플럭스' 모델이 사용됩니다.
각 이미지에 대해 기본적으로 난수 시드가 생성됩니다(다양성 보장)
이미지가 파일에 저장되었는지 여부에 관계없이 Base64로 인코딩된 이미지 데이터는 항상 반환됩니다.

이미지 생성 사용자 정의

// Example options for generateImage
const options = {
  // Model selection (defaults to 'flux')
  model: "flux",

  // Image dimensions
  width: 1024,
  height: 1024,

  // Generation options
  seed: 12345,  // Specific seed for reproducibility (defaults to random)
  enhance: true,  // Enhance the prompt using an LLM before generating (defaults to true)
  safe: false,  // Content filtering (defaults to false)

  // File saving options
  saveToFile: true,  // Set to false to skip saving to disk
  outputPath: "/path/to/save/directory",  // Custom save location
  fileName: "my_custom_name",  // Without extension
  format: "png"  // png, jpeg, jpg, or webp
};

이미지가 저장되는 위치

Claude 또는 다른 애플리케이션을 MCP 서버와 함께 사용하는 경우:

이미지는 Claude나 클라이언트 애플리케이션이 설치된 곳이 아니라, MCP 서버가 실행 중인 현재 작업 디렉토리에 저장됩니다 .
특정 디렉토리에서 MCP 서버를 수동으로 시작하면 이미지는 기본적으로 해당 디렉토리에 저장됩니다.
Claude Desktop이 자동으로 MCP 서버를 시작하면 이미지는 Claude Desktop의 작업 디렉토리(일반적으로 애플리케이션 데이터 폴더)에 저장됩니다.

생성된 이미지 찾기

Claude가 이미지를 생성한 후 응답하면 이미지가 저장된 전체 파일 경로가 포함됩니다.
outputPath 매개변수를 사용하여 익숙한 위치를 지정할 수 있습니다.
모범 사례: Claude에게 사진이나 다운로드 디렉토리와 같이 쉽게 액세스할 수 있는 폴더에 이미지를 저장하도록 요청하세요.

고유한 파일 이름

MCP 서버는 생성된 이미지가 항상 고유한 파일 이름을 가지도록 보장하고 기존 파일을 덮어쓰지 않도록 합니다.

기본 파일 이름은 다음과 같습니다.
- 프롬프트의 정리된 버전(처음 20자)
- 타임스탬프
- 무작위 접미사
사용자 정의 파일 이름 도 보호됩니다.
- 파일 이름을 지정하고 해당 이름을 가진 파일이 이미 존재하는 경우 숫자 접미사가 자동으로 추가됩니다.
- 예를 들어: sunset.png , sunset_1.png , sunset_2.png 등.

즉, 이전 이미지를 덮어쓸 걱정 없이 동일한 프롬프트나 파일 이름으로 여러 이미지를 안전하게 생성할 수 있습니다.

Base64 데이터 액세스

파일에 저장하는 경우에도 base64로 인코딩된 이미지 데이터는 항상 반환되며 다음 용도로 사용할 수 있습니다.

웹 페이지에 포함( <img src="data:image/png;base64,..." /> )
다른 서비스나 API로 전달
파일 시스템 작업 없이 메모리에서 처리
데이터 URI를 지원하는 애플리케이션에 표시

개발자를 위한

자신의 프로젝트에서 패키지를 사용하려면:

# Install as a dependency
npm install @pinkpixel/mcpollinations

# Import in your code
import { generateImageUrl, generateImage, repsondText, respondAudio, listTextModels, listImageModels, listAudioVoices } from '@pinkpixel/mcpollinations';

MCPollinations Multimodal MCP Server

Integrations