JinDaGe - together-mcp-server MCP Details

article

README

🚀 图像生成 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 服务器配置中：

配置示例

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

💻 使用示例

基础用法

该服务器提供一个工具：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 密钥
1. 在 api.together.xyz 登录。
2. 转到 API Keys 设置。
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 检查工具。

贡献

欢迎贡献！请按照以下步骤操作：

叉克仓库。
创建新分支（feature/my-new-feature）。
提交更改。
将分支推送到您的叉克。
提交 Pull Request。

功能请求和问题报告可通过 GitHub Issues 提交。请检查现有问题后再创建新问题。

对于重大变更，请先通过 Issue 讨论拟议的更改。

📄 许可证

该项目使用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

together-mcp-server