article
README
🚀 图像生成 MCP 服务器
本项目是一个基于模型上下文协议(MCP)的服务器,支持借助 Together AI 的 Flux.1 Schnell 模型无缝生成高质量图像。该服务器提供标准化接口,可用于指定图像生成参数。
🚀 快速开始
本服务器支持使用 Together AI 的 Flux.1 Schnell 模型生成高质量图像,提供标准化接口以指定图像生成参数。
✨ 主要特性
- 使用 Flux.1 Schnell 模型生成高质量图像。
- 支持自定义维度(宽度和高度)。
- 提供清晰的错误处理,针对提示验证和 API 问题。
- 集成简便,兼容 MCP 兼容客户端。
- 可选功能:将图像保存为 PNG 格式到磁盘。
📦 安装指南
安装依赖
npm install together-mcp
或直接运行:
npx together-mcp@latest
配置
在 MCP 服务器配置中添加以下内容:
💻 使用示例
基础用法
服务器提供一个工具:generate_image。此工具只有一个必填参数——提示。其他所有参数均为可选,未指定时将使用默认值。
参数
{
// 必填参数:图像生成的提示或指令
prompt: string;
// 可选参数:生成图像的数量,默认为1
n?: number;
// 可选参数:控制输出质量,默认为'high'
quality?: 'low' | 'medium' | 'high';
// 可选参数:指定图像尺寸,例如512x512
width?: number;
height?: number;
}
示例
生成一张高质量的512x512分辨率图像:
{
"prompt": "一只飞翔的白天鹅",
"n": 1,
"quality": "high",
"width": 512,
"height": 512
}
📚 详细文档
前提条件
- Node.js 版本 >= 16
- Together AI API 密钥
- 在 api.together.xyz 登录。
- 进入 API Keys 设置。
- 点击"创建"以生成新密钥。
- 复制生成的密钥用于 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 检查工具。
贡献
欢迎贡献!请按照以下步骤操作:
- Fork 仓库。
- 创建新分支(
feature/my-new-feature)。 - 提交更改。
- 将分支推送到个人仓库。
- 提交 Pull Request。
功能请求和问题报告可通过 GitHub Issues 提交。请在提交前检查是否存在相同的问题。
对于重大更改,请先通过 Issue 讨论您的提案。
📄 许可证
本项目遵循 MIT License 许可证。详细信息见 LICENSE 文件。
扫码联系在线客服