together ai image server

Local 2025-08-31 23:52:20 0
Image And Video Processing @zym9863/together-ai-image-server

A MCP server that enables Claude and other MCP-compatible assistants to generate images from text prompts using Together AI's image generation models.

English | 简体中文

A TypeScript-based MCP (Model Context Protocol) server for generating images using Together AI API.

Together AI Image Server MCP server

Overview

This server provides a simple interface to generate images using Together AI's image generation models through the MCP protocol. It allows Claude and other MCP-compatible assistants to generate images based on text prompts.

Features

Tools

  • generate_image - Generate images from text prompts
  • Takes a text prompt as required parameter
  • Optional parameters for controlling generation steps and number of images
  • Returns URLs and local paths to generated images

Prerequisites

  • Node.js (v14 or later recommended)
  • Together AI API key

Installation

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

# Install dependencies
npm install

Configuration

Set your Together AI API key as an environment variable:

# 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"

Alternatively, you can create a .env file in the project root:

TOGETHER_API_KEY=your-api-key-here

Development

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Usage with Claude Desktop

To use with Claude Desktop, add the server config:

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

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

Replace /path/to/together-ai-image-server with the actual path to your installation.

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

API Reference

generate_image

Generates images based on a text prompt using Together AI's image generation API.

Parameters:

  • prompt (string, required): Text prompt for image generation
  • steps (number, optional, default: 4): Number of diffusion steps (1-4)
  • n (number, optional, default: 1): Number of images to generate (1-4)

Returns:

JSON object containing: - image_urls: Array of URLs to the generated images - local_paths: Array of paths to locally cached images

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

[
  {
    "description": "Generate image from text prompt using Together AI API",
    "inputSchema": {
      "properties": {
        "n": {
          "description": "Number of images to generate (default: 1, max: 4)",
          "maximum": 4,
          "minimum": 1,
          "type": "number"
        },
        "prompt": {
          "description": "Text prompt for image generation",
          "type": "string"
        },
        "steps": {
          "description": "Number of diffusion steps (default: 4)",
          "maximum": 4,
          "minimum": 1,
          "type": "number"
        }
      },
      "required": [
        "prompt"
      ],
      "type": "object"
    },
    "name": "generate_image"
  }
]