多模态MCP授粉服务器（或：多模态MCP传粉服务系统）
一个模型上下文协议（MCP）服务器，它使AI助手能够通过Pollinations API生成图像、文本和音频
](https://smithery.ai/server/@pinkpixel-dev/mcpollinations) 
特点/功能
- 根据文本提示生成图像URL
- 生成图像并以Base64编码数据返回，同时保存为png、jpeg、jpg或webp格式（默认：png）
- 根据文本提示生成文本回复
- 根据文本提示生成音频回复
- 列出可用的图像和文本生成模型
- 无需认证
- 简单且轻便
- 兼容模型上下文协议（MCP）
系统要求
- Node.js版本14.0.0或更高版本
- 为了获得最佳性能，我们建议使用 Node.js 16.0.0 或更高版本 - Node.js 16以下版本使用AbortController的polyfill
快速入门
通过Smithery进行安装
通过……自动为Claude Desktop安装mcpollinations “Smithery”可以翻译为“铁匠铺”或“锻造工坊”。这个词源自“smith”，意指从事铁匠或锻造工作的人或地方：
npx -y @smithery/cli install @pinkpixel-dev/mcpollinations --client claude使用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配置（环境）
如果你希望跳过生成器，请将此内容复制到你的MCP客户端配置中：
{
"mcpollinations": {
"command": "npx",
"args": ["-y", "@pinkpixel/mcpollinations"],
"env": {
"token": "YOUR_TOKEN_OPTIONAL",
"referrer": "your-app-or-domain-optional",
"IMAGE_MODEL": "flux",
"IMAGE_WIDTH": "1024",
"IMAGE_HEIGHT": "1024",
"IMAGE_ENHANCE": "true",
"IMAGE_SAFE": "false",
"TEXT_MODEL": "openai",
"TEXT_TEMPERATURE": "0.7",
"TEXT_TOP_P": "0.9",
"TEXT_SYSTEM": "",
"AUDIO_VOICE": "alloy",
"OUTPUT_DIR": "./mcpollinations-output"
}
}
}- 按照提示自定义您的配置或使用默认设置。
- 设置输出目录（建议使用相对路径以提高可移植性） - Windows 用户考虑使用绝对路径（例如。， C:\Users\YourName\Pictures\MCPollinations）以更可靠地保存文件 - 在以下位置配置可选的认证方式（令牌、引用页）： env - 为图像生成配置默认参数（包括可用模型列表、尺寸等） - 为文本生成配置默认参数（提供可用模型列表） - 为音频生成（语音）配置默认参数
- 复制生成的内容
mcp.json将文件保存到您的应用程序的MCP设置.json文件中。
- 重启您的应用程序。
集成后，您可以使用以下命令：
“使用MCPollinations生成一幅海上日落的图像”
认证（可选）
MCPollinations支持可选的身份验证，以便访问更多模型和获得更好的速率限制。服务器在没有身份验证的情况下也能正常工作（免费版），但拥有API令牌的用户可以获得增强的访问权限。
配置方法
方法1：环境变量（推荐用于安全性考虑）
# Set environment variables before running the server
export POLLINATIONS_TOKEN="your-api-token"
export POLLINATIONS_REFERRER="https://your-domain.com"
# Then run the server
npx @pinkpixel/mcpollinations方法2：MCP配置文件（env） 在生成您的MCP配置时，请将auth置于内部 env 因此，您的MCP客户端会将它们作为环境变量传递给服务器进程：
{
"mcpollinations": {
"command": "npx",
"args": ["-y", "@pinkpixel/mcpollinations"],
"env": {
"token": "your-api-token",
"referrer": "your-app-or-domain"
}
}
}你也可以提供 POLLINATIONS_TOKEN 并且 POLLINATIONS_REFERRER 相反；服务器可以识别这两种形式。使用 token 并且 referrer 里面 env 建议用于MCP配置。
认证参数
token（可选）：您的Pollinations API令牌，用于增强访问权限referrer（可选）：您的域名/应用程序引用URL
这两个参数都是可选的。留空或不设置它们即可使用免费层级。
使用您的配置设置
MCPollinations 尊重您在（配置文件中）设置的 MCP 配置选项 env 作为默认设置。当你要求AI助手生成内容时：
- 您配置的模型、输出目录和参数将自动使用
- 覆盖（或重写）具体指示AI使用不同的设置
- “使用kontext模型生成一张图像” - “将这张图片保存到我的桌面文件夹中” - “为此次文本生成使用1.2的温度值”
示例说明：
- ✅ “生成一张日落图片” → 使用您配置的模型和输出目录
- ✅ “使用流模型生成日落图像”→ 仅覆盖模型
- ✅“生成一张日落图片并保存到C:\\Pictures”→ 仅覆盖输出路径
这确保您的偏好始终得到尊重，除非您特别希望为某个特定请求设置不同的参数。
故障排除
“AbortController is not defined” 错误
如果你在运行MCP服务器时遇到这个错误：
ReferenceError: AbortController is not defined这通常是由于在较旧版本的 Node.js（低于 16.0.0 版本）上运行所导致的。请尝试以下解决方案之一：
- 更新 Node.js （推荐）：
- 将 Node.js 更新到 16.0.0 或更高版本
- 使用全局安装
- 将包更新到最新版本：
npm install -g @pinkpixel/mcpollinations
# Run with npx
npx @pinkpixel/mcpollinations- 手动安装 AbortController：
- 如果由于某种原因，polyfill不起作用：
npm install node-abort-controller检查您的 Node.js 版本
检查您当前的 Node.js 版本：
node --version如果显示的版本低于16.0.0，请考虑升级以获得最佳兼容性。
可用工具
MCP服务器提供以下工具：
图像生成工具
generateImageUrl- 根据文本提示生成图像URLgenerateImage- 生成图像，将其作为Base64编码的数据返回，并默认保存为文件（PNG格式）editImage- 新 根据文本提示编辑或修改现有图像generateImageFromReference- 新 利用现有图像作为参考生成新图像listImageModels- 列出可用于图像生成的模型
文本与音频工具
respondText- 使用文本模型（可自定义参数）对提示作出文本回复respondAudio- 根据文本提示生成音频响应（可自定义语音参数）listTextModels- 列出可用于文本生成的模型listAudioVoices- 列出所有可用于音频生成的语音
文本生成详情
可用参数
这个（或“该”） respondText 该工具支持多个参数，用于微调文本生成：
model从可用的文本模型中选择（使用listTextModels查看当前选项)temperature(0.0-2.0): 控制输出中的随机性
- 较低的值（0.1-0.7）= 更具焦点和确定性 - 较高的值（0.8-2.0）= 更具创意和随机性
top_p(0.0-1.0): 通过核心采样控制多样性
- 较低的值 = 更关注可能的标记 - 更高的值 = 考虑更多的标记可能性
system系统提示以引导模型的行为和个性
定制文本生成
// Example options for respondText
const options = {
model: "openai", // Model selection
temperature: 0.7, // Balanced creativity
top_p: 0.9, // High diversity
system: "You are a helpful assistant that explains things clearly and concisely."
};配置示例
在您的MCP配置中，设置以下默认值： env 所以服务器会自动使用它们：
{
"mcpollinations": {
"env": {
"TEXT_MODEL": "openai",
"TEXT_TEMPERATURE": "0.7",
"TEXT_TOP_P": "0.9",
"TEXT_SYSTEM": "You are a helpful coding assistant."
}
}
}图像到图像生成（新功能！）
MCPollinations 现在支持通过两个专用工具实现强大的图像到图像生成功能：
编辑图像工具
非常适合修改现有图像：
- 移除物体“从这张图片中移除猫咪”
- 添加元素“给这个场景加一只狗”
- 更换背景“将背景替换为山脉”
- 风格修改“让灯光更具戏剧性”
“generateImageFromReference Tool”可以翻译为“基于参考图像生成图像工具”
非常适合创造变化和新风格：
- 风格迁移“让这张照片看起来像一幅画”
- 格式更改“将这个转换成卡通风格”
- 创意变体“为这个打造一个未来版”
- 艺术诠释“让这个看起来像草图”
支持的模型
kontext专为图像到图像任务优化的专用模型nanobanana谷歌新模型支持文本到图像及图像到图像的生成seedream字节跳动推出新型模型，支持文本生成图像及图像生成图像
多参考图像： editImage 并且 generateImageFromReference 接受 imageUrl 作为一个单一的URL或一个URL数组。服务器将数组编码为逗号分隔的形式 image API使用的参数。顺序很重要；kontext仅使用第一张图像，nanobanana最多支持~4个引用，seedream最多支持10个。
重要提示：仅限URL。图像到图像的工具需要可公开访问的HTTP(S) URL。本地文件路径、文件上传和base64/数据URL不受此MCP服务器支持（它不上传文件）。如果您需要使用本地图像，请将其托管在某个可访问的地方（例如，临时文件托管服务、对象存储或仓库中的原始链接），然后传递该URL。
示例用法
// Edit an existing image
const editResult = await editImage(
"change the background to a sunset beach",
"https://example.com/photo.jpg",
"nanobanana" // or "kontext", "seedream"
);
// Generate from reference
const referenceResult = await generateImageFromReference(
"make this into a watercolor painting",
"https://example.com/photo.jpg",
"seedream" // or "kontext", "nanobanana"
);图像生成详情
默认行为
当使用时 generateImage 工具：
- 默认情况下，图像会以PNG文件格式保存到磁盘
- 默认的保存位置是MCP服务器正在运行的当前工作目录
- 默认使用“通量”模型
- 默认情况下，为每张图像生成一个随机种子（以确保多样性）
- 无论图像是否保存到文件，总是返回Base64编码的图像数据
定制图像生成
// Example options for generateImage
const options = {
// Model selection (defaults to 'flux')
// Available models: "flux", "turbo", "kontext", "nanobanana", "seedream"
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服务器时：
- 图像保存在MCP服务器运行的当前工作目录中，而不是克劳德（Claude）或客户端应用程序的安装位置。
- 如果你从特定目录手动启动MCP服务器，图像将默认保存在该目录中。
- 如果Claude Desktop自动启动MCP服务器，图像将保存在Claude Desktop的工作目录中（通常是在应用程序数据文件夹中）。
💡 Windows 用户为了在Windows上可靠地保存文件，请在您的MCP配置中使用绝对路径，而不是相对路径（例如。， C:\Users\YourName\Pictures\MCPollinations 而不是 ./mcpollinations-output）。 相对路径可能无法按预期解析，这取决于工作目录的上下文。
查找生成的图像
- Claude在生成图像后的响应中包含了图像保存的完整文件路径
- 您可以使用（该功能）指定一个熟悉的位置
outputPath参数 - 最佳实践：请Claude将图片保存到易于访问的文件夹中，如您的“图片”或“下载”目录
唯一文件名
MCP服务器确保生成的图像始终具有唯一的文件名，并且永远不会覆盖现有文件：
- 默认文件名 包括：
- 提示信息的净化版本（前20个字符） - 时间戳 - 一个随机后缀
- 自定义文件名 也受到保护：
- 如果你指定了一个文件名，并且该文件名的文件已经存在，系统会自动添加一个数字后缀 - 例如： sunset.png， sunset_1.png， sunset_2.png等。
这意味着您可以安全地使用相同的提示或文件名生成多张图像，而无需担心覆盖之前的图像。
访问Base64数据
即使在将数据保存到文件时，也会始终返回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';
