Pollinations Multimodal

🚀 MCPollinations MCP 服務器

MCPollinations MCP 服務器是一款功能強大的工具，它支持圖像生成、文本響應、音頻生成以及模型管理等功能，能為用戶帶來高效且豐富的使用體驗。

🚀 快速開始

MCPollinations MCP 服務器可通過簡單的步驟完成安裝與啟動，以下是詳細介紹：

安裝步驟

1. 安裝依賴

npm install @pinkpixel/mcpollinations

2. 導入模塊

import { generateImageUrl, generateImage, respondText, respondAudio, listTextModels, listImageModels, listAudioVoices } from '@pinkpixel/mcpollinations';

3. 啟動服務器

• 在終端中運行：

npm start

• 默認端口：8080
• 訪問地址：http://localhost:8080

環境要求

• 操作系統：支持 Linux、macOS 和 Windows。
• Node.js 版本：需安裝 Node.js 14.19.1 或更高版本。

✨ 主要特性

MCPollinations MCP 服務器具備以下強大功能：

1. 圖像生成：使用不同模型（默認為 'flux'）生成高質量圖像，支持自定義尺寸、隨機種子和內容過濾。
2. 文本響應：通過 MCP 協議與客戶端應用（如 Claude Desktop）交互，處理文本指令。
3. 音頻生成：提供多種聲音選項，用於生成語音內容。
4. 模型管理：支持靈活的模型選擇和圖像格式設置。

📦 安裝指南

圖像生成選項

const options = {
  // 模型選擇（默認為 'flux'）
  model: "flux",

  // 圖像尺寸
  width: 1024,
  height: 1024,

  // 生成參數
  seed: 12345,  // 確保可重複性的具體種子值（默認為隨機）
  enhance: true,  // 使用 LLM 增強提示詞（默認開啟）
  safe: false,  // 內容過濾開關（默認關閉）

  // 文件保存選項
  saveToFile: true,  // 設置為 false 可跳過文件保存
  outputPath: "/path/to/save/directory",  // 自定義保存路徑
  fileName: "my_custom_name",  // 不帶擴展名
  format: "png"  // 支持格式：png、jpeg、jpg、webp
};

輸出路徑說明

• 默認位置：服務器運行目錄下的當前工作目錄。
• Claude Desktop 自動啟動時：保存在 Claude 的應用數據文件夾中（通常為用戶主目錄下）。

防重複機制

為了確保生成的圖像唯一性和避免覆蓋，MCP 服務器採取以下措施：

1. 默認文件名：

• 提示詞的淨化版本（前 20 字符）
• 時間戳
• 隨機後綴

2. 自定義文件名保護：

• 若指定文件已存在，自動添加數字後綴
• 示例：sunset.png、sunset_1.png 等。

Base64 數據訪問

無論是否保存到文件，Base64 編碼的圖像數據都會被返回，便於以下用途：

• 嵌入網頁 (<img>)
• 傳遞至其他服務或 API
• 內存處理
• 支持數據 URI 的應用程序顯示

💻 使用示例

基礎用法

將 MCPollinations 集成到項目中，可執行以下步驟：

1. 安裝依賴

npm install @pinkpixel/mcpollinations

2. 代碼示例

import { generateImageUrl, generateImage, respondText, respondAudio, listTextModels, listImageModels, listAudioVoices } from '@pinkpixel/mcpollinations';

// 使用案例：
const imageUrl = generateImageUrl('sunset over mountains', {
  width: 800,
  height: 600
});

📚 詳細文檔

常見問題

• 端口衝突：若啟動時提示 8080 端口被佔用，嘗試更換其他端口。
• 模塊未找到：確保正確安裝了 MCPollinations 包。

聯繫支持

如需幫助，請訪問 GitHub 倉庫 查看文檔或提交問題。