Together MCP Server

图像生成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”

重要提示

1. 只有 prompt 参数是必需的
2. 如果没有提供，所有可选参数都使用默认值
3. 提供参数时，参数必须满足其约束条件（例如，宽度/高度范围）
4. Base64响应可能很大-对于较大的图像，请使用URL格式
5. 保存图像时，请确保指定的目录存在并且可写

先决条件

• 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检查器

贡献

欢迎投稿！请按照以下步骤操作：

1. 分叉存储库
2. 创建新分支(feature/my-new-feature)
3. 提交您的更改
4. 把树枝推到叉子上
5. 打开拉取请求

功能请求和错误报告可以通过GitHub Issues提交。请在创建新问题之前检查现有问题。

对于重大更改，请先打开一个问题来讨论您提出的更改。

许可证

该项目根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。