图像生成 MCP 服务器

这是一个模型上下文协议（MCP）服务器，通过 Together AI 使用 Flux.1 Schnell 模型无缝生成高质量图像。此服务器提供了一个标准化的接口来指定图像生成参数。

功能

• 由 Flux.1 Schnell 模型支持的高质量图像生成
• 支持自定义尺寸（宽度和高度）
• 清晰的错误处理，用于提示验证和 API 问题
• 易于与兼容 MCP 的客户端集成
• 可选地将图像以 PNG 格式保存到磁盘

安装

npm install together-mcp

或者直接运行：

npx together-mcp@latest

配置

将以下内容添加到您的 MCP 服务器配置中：

{
  "mcpServers": {
    "together-image-gen": {
      "command": "npx",
      "args": ["together-mcp@latest -y"],
      "env": {
        "TOGETHER_API_KEY": "<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 并且保存成功，响应将包括保存位置的确认。

默认值

如果请求中未指定，将使用以下默认值：

• model: "black-forest-labs/FLUX.1-schnell-Free"
• width: 1024
• height: 768
• steps: 1
• n: 1
• response_format: "b64_json"

重要说明

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

先决条件

• Node.js >= 16
• Together AI API 密钥
  1. 在 api.together.xyz 登录
  2. 转到 API 密钥设置
  3. 点击“创建”以生成新的 API 密钥
  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. 分叉仓库
2. 创建新分支 (feature/my-new-feature)
3. 提交您的更改
4. 将分支推送到您的分叉
5. 打开拉取请求

功能请求和错误报告可以通过 GitHub Issues 提交。在创建新问题之前，请先检查是否已存在相关问题。

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

许可证

本项目根据 MIT 许可证获得许可。详情请参阅 LICENSE 文件。