Image Generator

Gere e salve imagens usando a API do Replicate.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Image Generator

Um servidor MCP que usa Replicate para gerar imagens e permite que os usuários as salvem.

Componentes

Recursos

O servidor implementa um sistema de armazenamento de imagens com:

  • Esquema de URI personalizado image:// para acessar imagens geradas individualmente
  • Cada recurso de imagem tem um nome baseado em seu prompt, descrição com data de criação e tipo MIME image/png

Prompts

O servidor fornece um único prompt:

  • generate-image: Cria prompts para gerar imagens usando Stable Diffusion
    • Argumento opcional "style" para controlar o estilo da imagem (realista/artística/abstrata)
    • Gera um modelo de prompt com orientação específica para cada estilo

Ferramentas

O servidor implementa três ferramentas:

  • generate-image: Gera uma imagem usando o modelo Stable Diffusion da Replicate
    • Aceita "prompt" como argumento de string obrigatório
    • Parâmetros opcionais incluem "negative_prompt", "width", "height", "num_inference_steps" e "guidance_scale"
    • Retorna a imagem gerada e sua URL
  • save-image: Salva uma imagem gerada no sistema de arquivos local
    • Aceita "image_url" e "prompt" como argumentos de string obrigatórios
    • Gera um ID único para a imagem e a salva no diretório "generated_images"
  • list-saved-images: Lista todas as imagens salvas
    • Retorna uma lista de todas as imagens salvas com seus metadados e miniaturas

Configuração

Token da API Replicate

Para usar este gerador de imagens, você precisa de um token da API Replicate:

  1. Crie uma conta em Replicate
  2. Obtenha seu token de API em https://replicate.com/account
  3. Crie um arquivo .env com base no modelo .env.example fornecido:
REPLICATE_API_TOKEN=your_replicate_api_token_here

Importante: O arquivo .env é excluído do controle de versão via .gitignore para evitar a exposição acidental do seu token de API. Nunca envie informações confidenciais para o seu repositório.

Configuração do Ambiente

  1. Clone o repositório:
git clone https://github.com/yourusername/image-generator.git
cd image-generator
  1. Crie e ative um ambiente virtual:
# Using venv
python -m venv .venv
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate
  1. Instale as dependências:
pip install -r requirements.txt
  1. Configure seu arquivo .env conforme descrito acima

Início Rápido

Instalação

Claude Desktop

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

Configuração de Servidores Não Publicados ``` "mcpServers": { "image-generator": { "command": "uv", "args": [ "--directory", "B:\NEWTEST\image-generator", "run", "image-generator" ] } } ```
Configuração de Servidores Publicados ``` "mcpServers": { "image-generator": { "command": "uvx", "args": [ "image-generator" ] } } ```

Uso

Depois que o servidor estiver em execução, você pode:

  1. Gerar uma imagem usando a ferramenta "generate-image" com um prompt descritivo
  2. Salvar a imagem gerada usando a ferramenta "save-image" com a URL da imagem e o prompt
  3. Visualizar todas as imagens salvas usando a ferramenta "list-saved-images"
  4. Acessar imagens salvas através da lista de recursos

Desenvolvimento

Compilação e Publicação

Para preparar o pacote para distribuição:

  1. Sincronize as dependências e atualize o arquivo de bloqueio:
uv sync
  1. Compile as distribuições do pacote:
uv build

Isso criará distribuições de origem e wheel no diretório dist/.

  1. Publique no PyPI:
uv publish

Observação: Você precisará definir as credenciais do PyPI via variáveis de ambiente ou flags de comando:

  • Token: --token ou UV_PUBLISH_TOKEN
  • Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP são executados via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, recomendamos fortemente o uso do MCP Inspector.

Você pode iniciar o MCP Inspector via npm com este comando:

npx @modelcontextprotocol/inspector uv --directory B:\NEWTEST\image-generator run image-generator

Ao iniciar, o Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.