返回 MCP 目录
public公开dns本地运行

manascb1344_together-mcp-server

一个基于Flux.1 Schnell模型的图像生成MCP服务器,通过Together AI提供高质量的图像生成服务,支持自定义参数和标准化接口。

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 服务器配置中添加以下内容:

配置示例 ```json { "mcpServers": { "together-image-gen": { "command": "npx", "args": ["together-mcp@latest -y"], "env": { "TOGETHER_API_KEY": "" } } } } ```

💻 使用示例

基础用法

服务器提供一个工具: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 密钥
    1. api.together.xyz 登录。
    2. 进入 API Keys 设置
    3. 点击"创建"以生成新密钥。
    4. 复制生成的密钥用于 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 检查工具。

贡献

欢迎贡献!请按照以下步骤操作:

  1. Fork 仓库。
  2. 创建新分支(feature/my-new-feature)。
  3. 提交更改。
  4. 将分支推送到个人仓库。
  5. 提交 Pull Request。

功能请求和问题报告可通过 GitHub Issues 提交。请在提交前检查是否存在相同的问题。

对于重大更改,请先通过 Issue 讨论您的提案。

📄 许可证

本项目遵循 MIT License 许可证。详细信息见 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端