使用说明

项目简介

MCPollinations MCP服务器是一个轻量级的MCP服务器实现，旨在简化AI助手（如Claude）与Pollinations API的集成。它允许AI助手通过标准的MCP协议调用Pollinations的图像、文本和音频生成服务，从而扩展AI助手的功能，使其能够生成多媒体内容。

主要功能点

多模态内容生成: 支持通过文本提示生成图像、文本和音频。
丰富的工具: 提供多种工具，包括图像URL生成、图像数据生成（Base64编码和文件保存）、音频生成（播放音频）、文本生成以及模型和声音列表查询。
易于集成: 提供MCP配置文件生成工具，方便快速集成到支持MCP协议的应用程序中。
无需认证: 简化部署和使用，无需复杂的身份验证配置。
轻量级: 系统资源占用少，易于部署和运行。

安装步骤

本MCP服务器基于Node.js环境运行。

安装Node.js: 确保你的系统已安装Node.js (推荐版本 >= 16.0.0)。你可以从 Node.js官网下载并安装。

使用npm或npx运行: 你可以选择全局安装或使用npx直接运行，或者克隆仓库后运行。

方法一：使用npx (推荐，无需安装)

npx @pinkpixel/mcpollinations

方法二：全局安装

npm install -g @pinkpixel/mcpollinations
mcpollinations
# 或使用 npx 运行
npx @pinkpixel/mcpollinations

方法三：克隆仓库后运行

git clone https://github.com/pinkpixel-dev/MCPollinations.git
cd MCPollinations
npm install # 安装依赖 (如果需要)
node pollinations-mcp-server.js
# 或使用 npx 运行
npx @pinkpixel/mcpollinations

服务器配置

MCP服务器需要生成一个 'mcp.json' 配置文件，以便MCP客户端（如Claude）能够连接和使用。

生成MCP配置文件: 运行以下命令生成配置文件：

npx @pinkpixel/mcpollinations generate-config
# 或
node /path/to/MCPollinations/generate-mcp-config.js

自定义配置 (可选): 按照提示自定义配置，例如：
- 输出目录: 设置保存生成文件的目录 (默认为 './mcpollinations-output')。
- 默认参数: 配置图像、文本和音频生成的默认模型、尺寸、声音等。
- 工具权限: 选择允许客户端调用的工具。
复制配置文件: 将生成的 'mcp.json' 文件复制到你的MCP客户端应用程序的配置目录中。通常，MCP客户端会指定一个目录用于存放MCP服务器的配置文件。
重启MCP客户端: 重启你的MCP客户端应用程序，使其加载新的MCP服务器配置。

生成的 'mcp.json' 配置文件示例 (包含详细注释):

{
  "mcpollinations": {  // 服务器名称，需与客户端配置一致
    "command": "npx",  // 启动服务器的命令，这里使用 npx
    "args": [          // 命令参数
      "-y",           // npx 参数，自动确认执行
      "@pinkpixel/mcpollinations" // 运行的 npm 包名
    ],
    "resources": {     // 资源配置
      "output_dir": "./mcpollinations-output" // 生成文件输出目录，相对于服务器运行目录
    },
    "default_params": { // 默认参数配置，用于工具调用时未指定参数的情况
      "image": {      // 图像生成默认参数
        "model": "flux",    // 默认图像模型
        "width": 1024,     // 默认宽度
        "height": 1024,    // 默认高度
        "safe": false,     // 默认安全模式
        "enhance": true    // 默认增强模式
      },
      "text": {       // 文本生成默认参数
        "model": "openai"   // 默认文本模型
      },
      "audio": {      // 音频生成默认参数
        "voice": "alloy"    // 默认音频声音
      }
    },
    "disabled": false, // 是否禁用该服务器，默认为 false (启用)
    "alwaysAllow": [  // 默认允许调用的工具列表
      "generateImageUrl",
      "generateImage",
      "listImageModels",
      "respondAudio",
      "listAudioVoices",
      "respondText",
      "listTextModels"
    ]
  }
}

注意: 请根据你的实际安装路径和需求调整 'command' 和 'args' 字段。如果全局安装，'command' 可以设置为 'mcpollinations'，'args' 可以为空数组 '[]'。使用 npx 方式则如示例所示。

基本使用方法

配置完成后，在支持MCP协议的客户端应用程序中，你可以使用自然语言指令来调用MCPollinations MCP服务器的功能。例如，在Claude中，你可以这样说：

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

或者

"让MCPollinations用 alloy 音色朗读 '你好世界'"

客户端会将这些指令转换为MCP请求，发送到MCPollinations MCP服务器，服务器会调用相应的Pollinations API生成内容，并将结果返回给客户端。

可用工具列表:

'generateImageUrl': 生成图像URL
'generateImage': 生成图像 (返回Base64数据并保存文件)
'respondAudio': 生成音频并播放
'respondText': 生成文本回复
'listImageModels': 列出可用图像模型
'listTextModels': 列出可用文本模型
'listAudioVoices': 列出可用音频声音

请参考仓库 README 文件中的 "Available Tools" 章节获取更详细的工具参数和使用说明。

关键词