MCP 服务器

Image Generation MCP Server

允许用户使用 Replicate 的模型，通过文本提示生成图像，并提供可配置的参数和完全符合 MCP 协议。

Tools

generate-image

Generate an image based on a prompt

README

图像生成 MCP 服务器

一个使用 Replicate 的 black-forest-labs/flux-schnell 模型生成图像的 MCP (模型上下文协议) 服务器实现。

理想情况下与 Cursor 的 MCP 功能一起使用，但可以与任何 MCP 客户端一起使用。

特性

从文本提示生成图像
可配置的图像参数（分辨率、宽高比、质量）
将生成的图像保存到指定目录
完全符合 MCP 协议
错误处理和验证

前提条件

Node.js 16+
Replicate API token
MCP 的 TypeScript SDK

设置

克隆存储库
安装依赖项：
```
npm install
```
通过更新 apiToken 常量，直接在 src/imageService.ts 的代码中添加您的 Replicate API token：
```
// 由于环境变量无法在 cursor 中轻松设置，因此不使用环境变量
const apiToken = "your-replicate-api-token-here";
```
注意： 如果与 Claude 一起使用，您可以在根目录中创建一个 .env 文件并在其中设置您的 API token：
```
REPLICATE_API_TOKEN=your-replicate-api-token-here
```
然后构建项目：
```
npm run build
```

用法

要与 cursor 一起使用：

转到设置
选择功能
向下滚动到“MCP 服务器”
单击“添加新的 MCP 服务器”
将类型设置为“命令”
将命令设置为：node ./path/to/dist/server.js

API 参数

参数	类型	必需	默认值	描述
`prompt`	string	是	-	用于图像生成的文本提示
`output_dir`	string	是	-	用于保存生成的图像的服务器目录路径
`go_fast`	boolean	否	false	启用更快的生成模式
`megapixels`	string	否	"1"	分辨率质量（"1"、"2"、"4"）
`num_outputs`	number	否	1	要生成的图像数量（1-4）
`aspect_ratio`	string	否	"1:1"	宽高比（"1:1"、"4:3"、"16:9"）
`output_format`	string	否	"webp"	图像格式（"webp"、"png"、"jpeg"）
`output_quality`	number	否	80	压缩质量（1-100）
`num_inference_steps`	number	否	4	去噪步骤数 (4-20)

示例请求

{
  "prompt": "black forest gateau cake spelling out 'FLUX SCHNELL'",
  "output_dir": "/var/output/images",
  "filename": "black_forest_cake",
  "output_format": "webp"
  "go_fast": true,
  "megapixels": "1",
  "num_outputs": 2,
  "aspect_ratio": "1:1"
}

示例响应

{
  "image_paths": [
    "/var/output/images/output_0.webp",
    "/var/output/images/output_1.webp"
  ],
  "metadata": {
    "model": "black-forest-labs/flux-schnell",
    "inference_time_ms": 2847
  }
}