MCP 服务器

MCPollinations Multimodal MCP Server

一个模型上下文协议服务器，它使 AI 助手能够通过 Pollinations API 生成图像、文本和音频，而无需身份验证。

README

MCPollinations 多模态 MCP 服务器

一个模型上下文协议 (MCP) 服务器，它使 AI 助手能够通过 Pollinations API 生成图像、文本和音频。

功能

从文本提示生成图像 URL
生成图像并将其作为 base64 编码的数据返回，并保存为 png、jpeg、jpg 或 webp 格式（默认：png）
从文本提示生成文本响应
从文本提示生成音频响应
列出可用的图像和文本生成模型
无需身份验证
简单轻量
兼容模型上下文协议 (MCP)

系统要求

Node.js: 14.0.0 或更高版本
- 为了获得最佳性能，我们建议使用 Node.js 16.0.0 或更高版本
- 低于 16 的 Node.js 版本使用 AbortController polyfill

快速开始

使用 MCP 服务器的最简单方法：

# 使用 npx 直接运行（无需安装）
npx @pinkpixel/mcpollinations

如果您更喜欢全局安装：

# 全局安装
npm install -g @pinkpixel/mcpollinations

# 运行服务器
mcpollinations
# 或
npx @pinkpixel/mcpollinations

或者克隆存储库：

# 克隆 git 存储库
git clone https://github.com/pinkpixel-dev/mcpollinations.git
# 运行服务器
mcpollinations
# 或
npx @pinkpixel/mcpollinations
# 或直接运行
node /path/to/MCPollinations/pollinations-mcp-server.js

MCP 集成

要将服务器与支持模型上下文协议 (MCP) 的应用程序集成：

生成一个 MCP 配置文件：

# 如果全局安装
npx @pinkpixel/mcpollinations generate-config

# 或直接运行
node /path/to/MCPollinations/generate-mcp-config.js

按照提示自定义您的配置或使用默认值。
- 设置自定义输出和临时目录（默认为可移植的相对路径）
- 配置图像生成的默认参数（包含可用模型、尺寸等的列表）
- 配置文本生成的默认参数（包含可用模型的列表）
- 配置音频生成的默认参数（声音）
- 指定应允许哪些工具
将生成的 mcp.json 文件复制到应用程序的 MCP 设置 .json 文件中。
重新启动您的应用程序。

集成后，您可以使用如下命令：

"使用 MCPollinations 生成一张海洋日落的图片"

故障排除

"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
# 使用 npx 运行
npx @pinkpixel/mcpollinations

手动安装 AbortController：
- 如果由于某种原因 polyfill 不起作用：
```
npm install node-abort-controller
```

检查您的 Node.js 版本

要检查您当前的 Node.js 版本：

node --version

如果显示的版本低于 16.0.0，请考虑升级以获得最佳兼容性。

可用工具

MCP 服务器提供以下工具：

generateImageUrl - 从文本提示生成图像 URL
generateImage - 生成图像，将其作为 base64 编码的数据返回，并默认将其保存到文件（PNG 格式）
respondAudio - 生成对文本提示的音频响应（可自定义的声音参数）
respondText - 使用文本模型响应提示的文本（可自定义的模型参数）
listImageModels - 列出可用于图像生成的模型
listTextModels - 列出可用于文本生成的模型
listAudioVoices - 列出所有可用于音频生成的声音

图像生成详情

默认行为

使用 generateImage 工具时：

默认情况下，图像以 PNG 文件格式保存到磁盘
默认保存位置是 MCP 服务器运行的当前工作目录
默认使用“flux”模型
默认情况下，为每个图像生成一个随机种子（确保多样性）
无论图像是否保存到文件，始终返回 Base64 编码的图像数据

自定义图像生成

// generateImage 的示例选项
const options = {
  // 模型选择（默认为“flux”）
  model: "flux",

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

  // 生成选项
  seed: 12345,  // 用于重现性的特定种子（默认为随机）
  enhance: true,  // 在生成之前使用 LLM 增强提示（默认为 true）
  safe: false,  // 内容过滤（默认为 false）

  // 文件保存选项
  saveToFile: true,  // 设置为 false 以跳过保存到磁盘
  outputPath: "/path/to/save/directory",  // 自定义保存位置
  fileName: "my_custom_name",  // 不带扩展名
  format: "png"  // png、jpeg、jpg 或 webp
};

图像保存位置

当使用 Claude 或其他带有 MCP 服务器的应用程序时：

图像保存在 MCP 服务器运行的当前工作目录中，而不是 Claude 或客户端应用程序的安装位置。
如果您从特定目录手动启动 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 的应用程序中显示

开发者须知

如果您想在自己的项目中使用该软件包：

# 作为依赖项安装
npm install @pinkpixel/mcpollinations

# 在您的代码中导入
import { generateImageUrl, generateImage, repsondText, respondAudio, listTextModels, listImageModels, listAudioVoices } from '@pinkpixel/mcpollinations';