Together AI Image Server

Together AI Image Server

English | 简体中文

一个基于 TypeScript 的 MCP（Model Context Protocol）服务，通过 Together AI API 生成图像。

概述

此服务通过 MCP 协议，提供了一个简单的接口，可使用 Together AI 的图像生成模型生成图像。Claude 和其他兼容 MCP 的助手可以根据文本提示词生成图像。

功能

工具

• generate_image - 根据文本提示词生成图像
  • 必须提供文本提示词
  • 可选参数用于控制生成步骤和图像数量
  • 返回生成图像的 URL 和本地路径

先决条件

• Node.js（建议使用 v14 或更高版本）
• Together AI API 密钥

安装

# Clone the repository
git clone https://github.com/zym9863/together-ai-image-server.git
cd together-ai-image-server

# Install dependencies
npm install

配置

将 Together AI API 密钥设为环境变量：

# On Linux/macOS
export TOGETHER_API_KEY="your-api-key-here"

# On Windows (Command Prompt)
set TOGETHER_API_KEY=your-api-key-here

# On Windows (PowerShell)
$env:TOGETHER_API_KEY="your-api-key-here"

或者，也可以在项目根目录中创建 .env 文件：

TOGETHER_API_KEY=your-api-key-here

开发

构建服务：

npm run build

在开发模式下自动重新构建：

npm run watch

在 Claude Desktop 中使用

若要在 Claude Desktop 中使用，请添加服务配置：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Together AI Image Server": {
      "command": "/path/to/together-ai-image-server/build/index.js"
    }
  }
}

将 /path/to/together-ai-image-server 替换为实际的安装路径。

调试

由于 MCP 服务通过 stdio 通信，调试可能比较困难。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

API 参考

generate_image

使用 Together AI 的图像生成 API，根据文本提示词生成图像。

参数：

• prompt（string，必填）：用于生成图像的文本提示词
• steps（number，可选，默认值：4）：扩散步骤数（1-4）
• n（number，可选，默认值：1）：要生成的图像数量（1-4）

返回值：

包含以下内容的 JSON 对象：

• image_urls：生成图像的 URL 数组
• local_paths：本地缓存图像的路径数组

许可证

MIT

贡献

欢迎贡献！请随时提交 Pull Request。