Pollinations Multimodal

🚀 MCPollinations MCP 服务器

MCPollinations MCP 服务器是一款功能强大的工具，可实现图像生成、文本响应、音频生成等功能，还支持灵活的模型管理，为用户提供了便捷高效的使用体验。

🚀 快速开始

MCPollinations MCP 服务器支持图像、文本、音频等多种类型的处理。你可以按照以下步骤进行安装和启动，开启使用之旅。

✨ 主要特性

1. 图像生成：使用不同模型（默认为 'flux'）生成高质量图像，支持自定义尺寸、随机种子和内容过滤。
2. 文本响应：通过 MCP 协议与客户端应用（如 Claude Desktop）交互，处理文本指令。
3. 音频生成：提供多种声音选项，用于生成语音内容。
4. 模型管理：支持灵活的模型选择和图像格式设置。

📦 安装指南

安装步骤

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 或更高版本。

📚 详细文档

配置指南

图像生成选项

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