内容
<p align="center">
<img src="./logo.png" width="300" alt="Nectar MCP logo" />
</p>
<p align="center">
<a href="https://pollinations.ai">
<img src="./pollinations-badge.svg" width="200" alt="Pollinations.ai" />
</a>
</p>
[](https://glama.ai/mcp/servers/pinkpixel-dev/nectar-mcp)
# 工具列表
Nectar 是一个为 Pollinations 图片和视频生成提供的标准输入输出MCP服务器。它为MCP客户端提供了一套小而精的工具集，用于生成图片、编辑图片、生成视频、列出可用的图片/视频模型以及检查花粉余额。
它故意不作为完整的Pollinations包装。不提供文本生成、音频、嵌入式、 sprawling控制面板。仅提供此服务器实际需要的创意媒体工具。
## 工具
| 工具 | 用途 |
| --- | --- |
| `pollinations_list_models` | 使用15分钟缓存、紧凑摘要、排序和功能过滤器，列出Pollinations当前的图片和视频模型。 |
| `pollinations_get_model_details` | 按名称或别名返回一个模型的完整元数据。 |
| `pollinations_generate_image` | 根据文本提示，使用模型、尺寸/尺寸、质量、种子、安全、透明度、提示增强、负面提示、参考图片和响应格式选项生成图片。 |
| `pollinations_edit_image` | 使用文本提示编辑一个或多个图片URL，包含模型、尺寸/尺寸、质量、种子、安全、透明度、提示增强、负面提示和响应格式选项。 |
| `pollinations_generate_video` | 根据文本提示，使用模型、时长、宽高比、分辨率、种子、音频、安全、质量和参考帧控制生成视频。 |
| `pollinations_check_balance` | 检查已认证的花粉余额或API密钥预算。 |
## 要求
- Node.js 20 或更新版本
- 从 [enter.pollinations.ai](https://enter.pollinations.ai) 获取的 Pollinations API 密钥
模型列表不需要身份验证。生成和余额工具需要 `POLLINATIONS_API_KEY`。
默认情况下，生成的图片、编辑的图片和视频保存在本地。 在MCP客户端环境块中设置 `NECTAR_OUTPUT_DIR` 以选择默认输出文件夹，或在每次工具调用时传递 `output_dir`。
## 安装
## MCP 客户端配置
大多数MCP客户端应通过服务器环境块传递API密钥：
```json
{
"mcpServers": {
"pixara": {
"command": "npx",
"args": ["-y", "@pinkpixel/nectar-mcp"],
"env": {
"POLLINATIONS_API_KEY": "sk_your_key_here",
"NECTAR_OUTPUT_DIR": "/absolute/path/to/nectar-output"
}
}
}
}
```
用于本地开发：
```bash
git clone https://github.com/pinkpixel-dev/nectar-mcp.git
cd nectar-mcp
npm install
npm run build
```
```json
{
"mcpServers": {
"nectar": {
"command": "node",
"args": ["/absolute/path/to/nectar-mcp/dist/index.js"],
"env": {
"POLLINATIONS_API_KEY": "sk_your_key_here",
"NECTAR_OUTPUT_DIR": "/absolute/path/to/nectar-output"
}
}
}
}
```
## 示例请求
询问您的MCP客户端：
```text
列出Pollinations视频模型并帮助我为9:16产品预告片选择一个模型。
```
```text
生成一张1024x1024的图片，图片中有一个小黄色机器人画家，处于精致的深色UI风格中。
```
```text
编辑此图片URL，使背景透明，主题看起来更高级。
```
```text
生成一个6秒16:9的视频，视频中有一条发光的花粉轨迹，横跨黑暗的工作室表面。
```
## 注意事项
- 图片生成使用Pollinations的OpenAI兼容图片生成端点。
- 图片编辑目前支持图片URL。本地多部分文件上传被故意排除在v1之外。
- 图片/视频工具默认为`save_output: true`，将base64响应和下载的URL转换为本地文件。
- 图片生成和图片编辑默认为Pollinations `response_format: "b64_json"`，因为本地解码是最可靠的保存路径。
- 保存的文件将保存到 `output_dir`、`NECTAR_OUTPUT_DIR` 或 `./nectar-output`。
- 保存的Pollinations媒体URL使用配置的 `POLLINATIONS_API_KEY` 下载。Nectar不会将该密钥发送到非Pollinations URL。
- 工具描述故意包含模型示例、参数指导、返回形状注释和错误处理提示，以便MCP客户端有足够的上下文来正确调用工具。
- 模型列表默认情况下是紧凑的。在代理需要一个模型的完整原始元数据时，请使用 `pollinations_get_model_details`。
- 视频生成返回最终媒体URL和响应元数据。
- 模型支持因功能而异，因此在模型特定的选项之前，请调用 `pollinations_list_models`。
- 服务器从不存储您的API密钥。您的MCP客户端通过进程环境传递它。
## 开发
```bash
npm run typecheck
npm run build
```
服务器通过标准输入输出进行通信，当直接启动时将保持运行。使用MCP客户端或检查器与之交互。
## 许可证
Apache-2.0
由 [Pink Pixel](https://pinkpixel.dev) 制作。
