Replicate

Execute modelos de IA para tarefas como geração de imagens usando a API do Replicate.

Documentação

Servidor MCP Replicate

Uma implementação de servidor FastMCP para a API Replicate, fornecendo acesso baseado em recursos à inferência de modelos de IA com foco em geração de imagens.

Recursos

🖼️ Geração e gerenciamento de imagens baseado em recursos
🔄 Atualizações em tempo real por meio de assinaturas
📝 Configuração de parâmetros orientada por modelos
🔍 Descoberta e seleção abrangente de modelos
🪝 Integração de webhooks para notificações externas
🎨 Predefinições de qualidade e estilo para resultados ideais
📊 Acompanhamento de progresso e monitoramento de status
🔒 Gerenciamento seguro de chaves de API

Prompts Disponíveis

O servidor fornece vários prompts especializados para diferentes tarefas:

Texto para Imagem (Principal)

Nosso prompt mais testado e robusto. Otimizado para gerar imagens de alta qualidade a partir de descrições de texto, com:

Controle detalhado de estilo
Predefinições de qualidade (rascunho, equilibrado, qualidade, extremo)
Personalização de tamanho e proporção
Acompanhamento de progresso e atualizações em tempo real

Exemplo:

Create a photorealistic mountain landscape at sunset with snow-capped peaks, quality level: quality, style: photorealistic

Outros Prompts

Imagem para Imagem: Transforme imagens existentes (em breve)
Seleção de Modelo: Obtenha ajuda para escolher o modelo certo para sua tarefa
Ajuda de Parâmetros: Entenda e configure os parâmetros do modelo

Pré-requisitos

Python 3.11 ou superior
Uma chave de API Replicate (obtenha uma em https://replicate.com/account)
UV para gerenciamento de dependências

Instalação

Instalando via Smithery

Para instalar o MCP Server Replicate para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @gerred/mcp-server-replicate --client claude

Instalando Manualmente

Você pode instalar o pacote diretamente do PyPI:

# Using UV (recommended)
uv pip install mcp-server-replicate

# Using UVX for isolated environments
uvx install mcp-server-replicate

# Using pip
pip install mcp-server-replicate

Integração com Claude Desktop

Certifique-se de ter a versão mais recente do Claude Desktop instalada
Abra sua configuração do Claude Desktop:

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
code %APPDATA%\Claude\claude_desktop_config.json

Adicione a configuração do servidor usando uma destas opções:

{
  "globalShortcut": "Shift+Alt+A",
  "mcpServers": {
    "replicate": {
      "command": "uv",
      "args": ["tool", "run", "mcp-server-replicate"],
      "env": {
        "REPLICATE_API_TOKEN": "APITOKEN"
      },
      "cwd": "$PATH_TO_REPO"
    }
  }
}

Defina sua chave de API Replicate:

# Option 1: Set in your environment
export REPLICATE_API_TOKEN=your_api_key_here

# Option 2: Create a .env file in your home directory
echo "REPLICATE_API_TOKEN=your_api_key_here" > ~/.env

Reinicie o Claude Desktop completamente

Você agora deve ver o ícone 🔨 no Claude Desktop, indicando que o servidor MCP está disponível.

Uso

Uma vez conectado ao Claude Desktop, você pode:

Gerar imagens com linguagem natural:

Create a photorealistic mountain landscape at sunset with snow-capped peaks

Navegar pelas suas gerações:
```
Show me my recent image generations
```
Pesquisar entre as gerações:
```
Find my landscape generations
```

Verificar o status da geração:

What's the status of my last generation?

Solução de Problemas

Servidor não aparecendo no Claude Desktop

Verifique os logs do Claude Desktop:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Verifique sua configuração:

Certifique-se de que o caminho em claude_desktop_config.json seja absoluto
Garanta que o UV esteja instalado e no seu PATH
Verifique se sua chave de API Replicate está definida

Tente reiniciar o Claude Desktop

Para solução de problemas mais detalhada, consulte nosso Guia de Depuração.

Documentação

Desenvolvimento

Clone o repositório:

git clone https://github.com/gerred/mcp-server-replicate.git
cd mcp-server-replicate

Instale as dependências de desenvolvimento:

uv pip install --system ".[dev]"

Instale os hooks de pré-commit:

pre-commit install

Execute os testes:

pytest

Contribuição

Aceitamos contribuições! Consulte nosso Guia de Contribuição para detalhes.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.