Together AI 图像生成 MCP 服务器

本项目是一个 MCP 服务器，它利用 Together AI 的图像生成模型，对外提供图像生成能力。通过注册 'generate_image' 工具，MCP 客户端可以调用此服务器根据文本提示词生成图像。

主要功能点

文本到图像生成: 根据用户提供的文本描述，使用 Together AI 模型生成图像。
模型选择: 支持用户指定使用的 Together AI 图像生成模型。
参数可配置: 允许用户自定义图像的宽度、高度、生成步骤和生成数量等参数。
多种输出格式: 支持将生成的图像保存为 PNG, JPG, SVG 等格式。
图像后处理: 自动处理图像尺寸，并保持图像的纵横比。
详细信息返回: 返回图像的文件路径、文件名和尺寸等详细元数据。

安装步骤

安装 Node.js 和 npm: 确保你的计算机上已安装 Node.js 和 npm 包管理器。

克隆仓库: 将 GitHub 仓库克隆到本地：

git clone https://github.com/stefanskiasan/togetherai-image-mcp-server.git
cd togetherai-image-mcp-server

安装依赖: 在仓库根目录下运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令编译 TypeScript 代码并构建服务器：
```
npm run build
```

服务器配置

要将此 MCP 服务器添加到 MCP 客户端（例如 Cline），你需要在客户端的 MCP 服务器配置文件中添加以下配置信息。以下是一个 'cline_mcp_settings.json' 文件的配置示例。请根据你的实际安装路径和 Together AI API 密钥修改配置。

{
  "mcpServers": {
    "togetherai-image": {  //  服务器名称，在客户端中通过此名称引用
      "command": "node", // 启动服务器的命令，这里使用 Node.js 运行时
      "args": ["/path/to/togetherai-image-server/build/index.js"], // 服务器启动参数，指向构建后的 index.js 文件，请替换为实际路径
      "env": {
        "TOGETHER_API_KEY": "YOUR_TOGETHER_AI_API_KEY" // Together AI API 密钥，请替换为你在 Together AI 平台申请的 API 密钥
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置说明:

'"togetherai-image"': 你为该服务器定义的名称，客户端将使用此名称来调用服务。
'"command": "node"': 指定用于启动服务器的命令，这里假设你使用 Node.js 运行环境。
'"args": [...]"': 包含启动服务器所需的参数，这里指向构建后的 'index.js' 文件路径。请务必将 '/path/to/togetherai-image-server/build/index.js' 替换为服务器文件在你本地文件系统中的实际路径。
'"env": { "TOGETHER_API_KEY": "YOUR_TOGETHER_AI_API_KEY" }"': 设置环境变量，'TOGETHER_API_KEY' 用于存储你的 Together AI API 密钥。请将 '"YOUR_TOGETHER_AI_API_KEY"' 替换为你自己的 API 密钥。

基本使用方法

配置完成后，在 MCP 客户端中，你可以使用 '<use_mcp_tool>' 标签来调用 'generate_image' 工具。以下是一个示例，演示如何生成一张猫的图片并将其保存到桌面：

<use_mcp_tool>
  <server_name>togetherai-image</server_name>
  <tool_name>generate_image</tool_name>
  <arguments>
  {
    "prompt": "A cute cat sitting on a windowsill",
    "outputDir": "/Users/username/Desktop/generated-images"
  }
  </arguments>
</use_mcp_tool>

使用说明:

'<server_name>togetherai-image</server_name>': 指定要使用的 MCP 服务器名称，这里需要与你在 'cline_mcp_settings.json' 中配置的服务器名称 '"togetherai-image"' 一致。
'<tool_name>generate_image</tool_name>': 指定要调用的工具名称，即 'generate_image'。
'<arguments> {...} </arguments>': 工具的参数，以 JSON 格式传递。
- '"prompt"': 必需参数，文本描述，用于描述你想要生成的图像内容。
- '"outputDir"': 可选参数，指定图像保存的目录。如果未指定，默认保存到服务器工作目录下的 'output' 文件夹中。请将 '/Users/username/Desktop/generated-images' 替换为你希望保存图片的实际桌面路径。
- 其他可选参数，如 'model', 'width', 'height', 'steps', 'n', 'format' 等，可以根据 'README.md' 文件中的描述进行配置。

执行上述 MCP 指令后，服务器将调用 Together AI API 生成图像，并将结果保存到指定的 'outputDir' 目录中。你可以在 MCP 客户端中查看工具返回的 JSON 响应，其中包含了生成图像的文件路径和尺寸等信息。

关键词

Together AI 图像生成 MCP 服务器

主要功能点

安装步骤

服务器配置

基本使用方法

信息