🚀 图像生成 MCP 服务器
本项目是一个基于模型上下文协议（MCP）的服务器，借助 Together AI 平台，运用 Flux.1 Schnell 模型实现高质量的图像生成。它提供了标准化接口，方便用户指定图像生成的各项参数。
🚀 快速开始
本服务器借助 Flux.1 Schnell 模型，能实现高质量的图像生成。同时，它提供标准化接口，可轻松指定图像生成参数。
✨ 主要特性
- 高质量图像生成：使用 Flux.1 Schnell 模型实现高质量图像生成。
- 尺寸可自定义：支持可自定义的尺寸（宽度和高度）。
- 清晰的错误处理：提供清晰的错误处理，针对提示验证和 API 问题。
- 集成简便：集成 MCP 兼容客户端的简便性。
- 可选的图像保存功能：可选的图像保存到磁盘功能（以 PNG 格式）。
📦 安装指南
安装依赖
npm install together-mcp
或直接运行：
npx together-mcp@latest
配置
将以下内容添加到您的 MCP 服务器配置中：
💻 使用示例
基础用法
该服务器提供一个工具：generate_image。此工具只有一个必需参数——提示。其他所有参数均为可选，默认值若未指定将使用合理默认设置。
参数
{
// 必需
prompt: string; // 图像的文本描述
// 可选，默认值如下：
width?: number; // 图像宽度（像素）
height?: number; // 图像高度（像素）
quality?: number; // 图像质量（1-100，数值越高图像越大）
format?: string; // 输出格式（png, jpeg, webp，默认为 png）
}
响应格式
{
"status": "success", // 状态：成功或失败
"message": "", // 消息描述
"data": { // 数据部分，包含生成的图像信息
"id": string, // 图像 ID
"url": string // 图像 URL
}
}
📚 详细文档
先决条件
- Node.js >= 16
- Together AI API 密钥
- 在 api.together.xyz 登录。
- 转到 API Keys 设置。
- 点击 "创建" 生成新 API 密钥。
- 复制生成的密钥用于 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）。 - 提交更改。
- 将分支推送到您的叉克。
- 提交 Pull Request。
功能请求和问题报告可通过 GitHub Issues 提交。请检查现有问题后再创建新问题。
对于重大变更，请先通过 Issue 讨论拟议的更改。
📄 许可证
该项目使用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。