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 仓库 查看文档或提交问题。