图像生成MCP服务器
一种模型上下文协议（MCP）服务器，通过Together AI使用Flux.1 Schnell模型无缝生成高质量图像。该服务器提供了一个标准化的接口来指定图像生成参数。
特性
- Flux.1 Schnell模型支持的高质量图像生成
- 支持自定义尺寸（宽度和高度）
- 为即时验证和API问题清除错误处理
- 与MCP兼容客户端轻松集成
- 可选的PNG格式图像保存到磁盘
安装
npm install together-mcp或者直接运行：
npx together-mcp@latest配置
添加到MCP服务器配置中：
Configuration Example
{
"mcpServers": {
"together-image-gen": {
"command": "npx",
"args": ["together-mcp@latest -y"],
"env": {
"TOGETHER_API_KEY": ""
}
}
}
}用法
服务器提供了一个工具： generate_image
使用generate_image
此工具只有一个必需参数-提示。所有其他参数都是可选的，如果没有提供，则使用合理的默认值。
参数
{
// Required
prompt: string; // Text description of the image to generate
// Optional with defaults
model?: string; // Default: "black-forest-labs/FLUX.1-schnell-Free"
width?: number; // Default: 1024 (min: 128, max: 2048)
height?: number; // Default: 768 (min: 128, max: 2048)
steps?: number; // Default: 1 (min: 1, max: 100)
n?: number; // Default: 1 (max: 4)
response_format?: string; // Default: "b64_json" (options: ["b64_json", "url"])
image_path?: string; // Optional: Path to save the generated image as PNG
}最小请求示例
只需要提示：
{
"name": "generate_image",
"arguments": {
"prompt": "A serene mountain landscape at sunset"
}
}带图像保存的完整请求示例
覆盖任何默认值并指定保存图像的路径：
{
"name": "generate_image",
"arguments": {
"prompt": "A serene mountain landscape at sunset",
"width": 1024,
"height": 768,
"steps": 20,
"n": 1,
"response_format": "b64_json",
"model": "black-forest-labs/FLUX.1-schnell-Free",
"image_path": "/path/to/save/image.png"
}
}响应格式
响应将是一个JSON对象，其中包含：
{
"id": string, // Generation ID
"model": string, // Model used
"object": "list",
"data": [
{
"timings": {
"inference": number // Time taken for inference
},
"index": number, // Image index
"b64_json": string // Base64 encoded image data (if response_format is "b64_json")
// OR
"url": string // URL to generated image (if response_format is "url")
}
]
}如果提供了image_path并且保存成功，则响应将包括对保存位置的确认。
默认值
如果请求中没有指定，则使用这些默认值：
- 型号：“黑森林实验室/FLUX.1-schnell-Free”
- 宽度：1024
- 高度：768
- 步骤：1
- n： 1
- 响应格式：“b64_json”
重要提示
- 只有
prompt参数是必需的 - 如果没有提供，所有可选参数都使用默认值
- 提供参数时，参数必须满足其约束条件（例如，宽度/高度范围）
- Base64响应可能很大-对于较大的图像，请使用URL格式
- 保存图像时，请确保指定的目录存在并且可写
先决条件
- Node.js>=16
- 一起AI API密钥
1. 登录地址： api.together.xyz 1. 引导到 API密钥设置 1. 单击“创建”生成新的API密钥 1. 复制生成的密钥以用于MCP配置
依赖项
{
"@modelcontextprotocol/sdk": "0.6.0",
"axios": "^1.6.7"
}发展
克隆并构建项目：
git clone https://github.com/manascb1344/together-mcp-server
cd together-mcp-server
npm install
npm run build可用脚本
npm run build-构建TypeScript项目npm run watch-观察变化并重建npm run inspector-运行MCP检查器
贡献
欢迎投稿！请按照以下步骤操作：
- 分叉存储库
- 创建新分支(
feature/my-new-feature) - 提交您的更改
- 把树枝推到叉子上
- 打开拉取请求
功能请求和错误报告可以通过GitHub Issues提交。请在创建新问题之前检查现有问题。
对于重大更改，请先打开一个问题来讨论您提出的更改。
许可证
该项目根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。