Imaginode

Servidor MCP Imaginode

Gere imagens e vídeos com IA a partir do Claude, Cursor ou qualquer cliente MCP, com tecnologia de imaginode.ai, o estúdio de criação de IA em node-canvas.

• Mais de 48 modelos em uma única conta: Flux 2, Nano Banana 2, Seedream 5, GPT Image, Kling V3, Seedance 2.5, Veo 3.1, Hailuo, Wan e outros.
• Preços transparentes: cada geração retorna o custo exato em créditos (1 crédito = €0,01) antes do resultado. Gerações com falha são reembolsadas automaticamente.
• Servidor remoto, nada para instalar: https://imaginode.ai/api/mcp (HTTP Streamable).

Início rápido

1. Crie uma conta gratuita em imaginode.ai (créditos de teste incluídos, e-mail verificado obrigatório).
2. Crie uma chave de API em seu perfil, seção API keys. O segredo imk_… é exibido apenas uma vez.
3. Conecte seu cliente:

Claude Code

claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer imk_YOUR_KEY"

Claude.ai / Claude Desktop: adicione um conector personalizado com a URL https://imaginode.ai/api/mcp e o mesmo cabeçalho Authorization.

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "imaginode": {
      "url": "https://imaginode.ai/api/mcp",
      "headers": { "Authorization": "Bearer imk_YOUR_KEY" }
    }
  }
}

Depois, basta pedir ao seu assistente: "Gere uma imagem cinematográfica de uma raposa vermelha em uma floresta enevoada" ou "Faça um vídeo de 5 segundos de ondas do oceano ao pôr do sol".

Ferramentas

Ferramenta	O que faz
list_models	Catálogo de modelos de imagem e vídeo com preços em créditos e opções faturáveis.
generate_image	Gera uma imagem e aguarda o resultado: a URL é retornada diretamente. Modelo padrão: Nano Banana 2.
generate_video	Inicia uma geração de vídeo e retorna um request_id além do custo exato. Modelo padrão: Seedance 2.0.
get_generation_status	Acompanha uma geração (running, completed com URLs de saída, ou failed com reembolso automático).

Os vídeos normalmente levam de 1 a 5 minutos (até 30 para trabalhos longos): consulte get_generation_status a cada 30 segundos.

API REST direta

O servidor MCP é uma fachada leve sobre três endpoints públicos que você também pode chamar de qualquer script:

• GET https://imaginode.ai/api/models: catálogo de modelos e preços, sem autenticação.
• POST https://imaginode.ai/api/generate: corpo { "model", "prompt", "duration", "resolution", "aspectRatio", "audio", "imageUrls" }, cabeçalho Authorization: Bearer imk_…. Retorna { requestId, cost, balance }.
• GET https://imaginode.ai/api/generate/status?requestId=…: retorna running, completed (com outputUrls) ou failed (reembolsado).

As imagens de entrada devem ser mídias hospedadas na sua conta Imaginode (biblioteca de mídia ou gerações anteriores).

Documentação completa: imaginode.ai/docs/api-mcp.

Limites e segurança

• As chaves de API são segredos pessoais: exibidas uma única vez, revogáveis instantaneamente pelo seu perfil, máximo de 5 chaves ativas.
• Cada chave tem limite de 10 gerações por minuto.
• Cada chamada gasta os créditos da sua própria conta, pelos mesmos preços do canvas; você nunca pode gastar além do seu saldo, e falhas são reembolsadas.

Habilidade do Claude

A pasta skills/imaginode contém uma habilidade opcional do Claude Code que ensina o Claude a usar bem este servidor (iteração priorizando modelos baratos, consciência de custos, cadência de consultas). Instale copiando a pasta para ~/.claude/skills/imaginode.

Licença

MIT. O servidor em si roda em imaginode.ai; este repositório hospeda seu manifesto público, documentação e habilidade.