Together AI Image Server

Together AI Image Server

Inglês | 简体中文

Um servidor MCP (Model Context Protocol) baseado em TypeScript para gerar imagens usando a API Together AI.

Visão Geral

Este servidor fornece uma interface simples para gerar imagens usando os modelos de geração de imagens da Together AI através do protocolo MCP. Ele permite que o Claude e outros assistentes compatíveis com MCP gerem imagens com base em prompts de texto.

Recursos

Ferramentas

• generate_image - Gera imagens a partir de prompts de texto
  • Recebe um prompt de texto como parâmetro obrigatório
  • Parâmetros opcionais para controlar as etapas de geração e o número de imagens
  • Retorna URLs e caminhos locais para as imagens geradas

Pré-requisitos

• Node.js (v14 ou posterior recomendado)
• Chave da API Together AI

Instalação

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

# Install dependencies
npm install

Configuração

Defina sua chave da API Together AI como uma variável de ambiente:

# 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, você pode criar um arquivo .env na raiz do projeto:

TOGETHER_API_KEY=your-api-key-here

Desenvolvimento

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Uso com Claude Desktop

Para usar com o Claude Desktop, adicione a configuração do servidor:

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

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

Substitua /path/to/together-ai-image-server pelo caminho real da sua instalação.

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.

Referência da API

generate_image

Gera imagens com base em um prompt de texto usando a API de geração de imagens da Together AI.

Parâmetros:

• prompt (string, obrigatório): Prompt de texto para geração de imagem
• steps (número, opcional, padrão: 4): Número de etapas de difusão (1-4)
• n (número, opcional, padrão: 1): Número de imagens a gerar (1-4)

Retorna:

Objeto JSON contendo:

• image_urls: Matriz de URLs para as imagens geradas
• local_paths: Matriz de caminhos para imagens em cache local

Licença

MIT

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.