Together AI Image Server

Un servidor basado en TypeScript para generar imágenes utilizando la API de Together AI.

Documentación

Servidor de Imágenes Together AI

Inglés | 简体中文

Un servidor MCP (Protocolo de Contexto de Modelo) basado en TypeScript para generar imágenes usando la API de Together AI.

Together AI Image Server MCP server

Descripción general

Este servidor proporciona una interfaz simple para generar imágenes usando los modelos de generación de imágenes de Together AI a través del protocolo MCP. Permite que Claude y otros asistentes compatibles con MCP generen imágenes basadas en indicaciones de texto.

Características

Herramientas

  • generate_image - Genera imágenes a partir de indicaciones de texto
    • Toma una indicación de texto como parámetro requerido
    • Parámetros opcionales para controlar los pasos de generación y el número de imágenes
    • Devuelve URLs y rutas locales de las imágenes generadas

Requisitos previos

  • Node.js (v14 o posterior recomendado)
  • Clave de API de Together AI

Instalación

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

# Install dependencies
npm install

Configuración

Establezca su clave de API de Together AI como variable de entorno:

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

Alternativamente, puede crear un archivo .env en la raíz del proyecto:

TOGETHER_API_KEY=your-api-key-here

Desarrollo

Compile el servidor:

npm run build

Para desarrollo con recompilación automática:

npm run watch

Uso con Claude Desktop

Para usar con Claude Desktop, agregue la configuración del servidor:

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

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

Reemplace /path/to/together-ai-image-server con la ruta real de su instalación.

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Referencia de la API

generate_image

Genera imágenes basadas en una indicación de texto usando la API de generación de imágenes de Together AI.

Parámetros:

  • prompt (cadena, requerido): Indicación de texto para la generación de imágenes
  • steps (número, opcional, predeterminado: 4): Número de pasos de difusión (1-4)
  • n (número, opcional, predeterminado: 1): Número de imágenes a generar (1-4)

Devuelve:

Objeto JSON que contiene:

  • image_urls: Matriz de URLs de las imágenes generadas
  • local_paths: Matriz de rutas de las imágenes almacenadas en caché localmente

Licencia

MIT

Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar una Solicitud de Extracción (Pull Request).