Jimeng MCP Server

Um servidor MCP que se integra ao serviço de geração de imagens Jimeng AI.

GitHub
53
Experimente este MCPPatrocinado

Documentação

Servidor MCP Jimeng

Projeto de servidor Model Context Protocol (MCP) implementado em TypeScript, integrado ao serviço de geração de imagens Jimeng AI, que chama diretamente a API oficial do Jimeng por meio de engenharia reversa.

Funcionalidades

  • Construído com TypeScript
  • Usa tsup como ferramenta de build
  • Implementa o protocolo MCP, com suporte à comunicação padrão via stdio
  • Chama diretamente o serviço de geração de imagens Jimeng AI, sem necessidade de APIs de terceiros
  • Oferece ferramentas de geração de imagens para vários modelos Jimeng
  • Suporta diversos ajustes de parâmetros de imagem, como dimensões, nível de detalhe, prompt negativo, etc.
  • Suporta mistura de imagens / geração com imagem de referência (por meio do parâmetro filePath, com suporte a imagens locais e URLs de imagem)
  • Suporta geração de vídeo, com opção de adicionar imagens de referência (quadros inicial e final definidos pelo parâmetro filePath)

Instalação

Instalação via Smithery

Para instalar o jimeng-mcp automaticamente no Claude Desktop via Smithery, execute o seguinte comando:

npx -y @smithery/cli install @c-rick/jimeng-mcp --client claude

Instalação manual

# 使用yarn安装依赖
yarn install

# 或使用npm安装依赖
npm install

Configuração de ambiente

Defina as seguintes variáveis de ambiente na configuração do cliente MCP (como Claude Desktop):

Acesse o projeto hospedado no Smithery, clique em json, preencha JIMENG_API_TOKEN, clique em connect e gere o seguinte json de configuração mcpServers:

{
  "mcpServers": {
    "jimeng-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@c-rick/jimeng-mcp",
        "--key",
        "[Smithery生成]",
        "--profile",
        "[Smithery生成]"
      ]
    }
  }
}

Como obter o JIMENG_API_TOKEN

  1. Acesse o site oficial do Jimeng AI e faça login na sua conta
  2. Pressione F12 para abrir as ferramentas de desenvolvedor do navegador
  3. Em Application > Cookies, encontre o valor de sessionid
  4. Configure o valor de sessionid encontrado como a variável de ambiente JIMENG_API_TOKEN

Rotação de múltiplos tokens: é possível configurar vários tokens separados por vírgula em inglês; o servidor os utilizará em rotação sequencial, ideal para balanceamento de carga entre múltiplas contas.

JIMENG_API_TOKEN=token1,token2,token3

Desenvolvimento

# 开发模式运行
yarn dev

# 使用nodemon开发并自动重启
yarn start:dev

Build

# 构建项目
yarn build

Execução

# 启动服务器
yarn start

# 测试MCP服务器
yarn test

Exemplo de configuração no Claude Desktop

A seguir, um exemplo completo de configuração deste servidor MCP no Claude Desktop:

{
  "mcpServers": {
    "jimeng": {
      "command": "node",
      "args": ["/path/to/jimeng-mcp/lib/index.js"],
      "env": {
        "JIMENG_API_TOKEN": "your_jimeng_session_id_here"
      }
    }
  }
}

Geração de imagens Jimeng AI

Este servidor MCP chama diretamente a API de geração de imagens do Jimeng AI, oferecendo a ferramenta de geração de imagens:

generateImage - Envia a solicitação de geração de imagem e retorna uma lista de URLs de imagem

  • Parâmetros:
    • prompt: descrição textual da imagem a ser gerada (obrigatório)
    • filePath: caminho de imagem local ou URL de imagem (opcional; se preenchido, ativa a função de mistura de imagens / geração com imagem de referência)
    • model: nome do modelo, valores possíveis: jimeng-5.0, jimeng-4.6, jimeng-4.5, jimeng-4.1, jimeng-4.0, jimeng-3.1, jimeng-3.0 (opcional, padrão: jimeng-5.0; na mistura de imagens, alterna automaticamente para jimeng-3.0)
    • width: largura da imagem, valor padrão: 1024 (opcional)
    • height: altura da imagem, valor padrão: 1024 (opcional)
    • sample_strength: nível de detalhe, valor padrão: 0,5, intervalo de 0 a 1 (opcional)
    • negative_prompt: prompt negativo, informa ao modelo o que não deve ser gerado (opcional)

Observação:

  • filePath aceita caminhos absolutos/relativos locais e URLs de imagem.
  • Se filePath for especificado, o modo de mistura de imagens / geração com referência será ativado automaticamente, e o modelo subjacente alternará automaticamente para jimeng-2.0-pro.
  • Imagens da web devem ser publicamente acessíveis.

Função de mistura de imagens / geração com imagem de referência

Para gerar imagens com base em uma imagem existente, basta informar o parâmetro filePath (aceita caminho local ou URL de imagem), permitindo recursos avançados como fusão de estilos e geração com imagem de referência.

Exemplo:

// 参考图片混合生成
client.callTool({
  name: "generateImage",
  arguments: {
    prompt: "梵高风格的猫",
    filePath: "./test.png", // 本地图片路径
    sample_strength: 0.6
  }
});

ou

// 使用网络图片作为参考
client.callTool({
  name: "generateImage",
  arguments: {
    prompt: "未来城市",
    filePath: "https://example.com/your-image.png"
  }
});

Modelos suportados

O servidor suporta os seguintes modelos Jimeng AI:

  • Modelos de imagem (baseados em Seedream)
  • jimeng-5.0: Seedream 5.0 Lite, resposta a instruções mais precisa e geração mais inteligente (padrão)
  • jimeng-4.6: Seedream 4.6, melhor consistência de retratos, melhor custo-benefício
  • jimeng-4.5: Seedream 4.5, consistência, estilo e resposta a texto/imagem aprimorados
  • jimeng-4.1: Seedream 4.0 Design, criatividade, estética e consistência mais profissionais
  • jimeng-4.0: Seedream 4.0, suporta múltiplas imagens de referência e geração de séries
  • jimeng-3.1: Seedream 3.0, rica diversidade estética, imagens mais vibrantes e nítidas
  • jimeng-3.0: Seedream 3.0, textura cinematográfica, texto mais preciso, geração direta de imagens 2K em alta definição
  • Modelos antigos (compatibilidade reversa): jimeng-2.1, jimeng-2.0-pro, jimeng-2.0, jimeng-1.4, jimeng-xl-pro
  • Modelos de vídeo (baseados em Seedance)
  • jimeng-video-seedance-2.0: Seedance 2.0, o rei versátil, aceita referências de áudio, vídeo, texto e imagem
  • jimeng-video-seedance-2.0-fast: Seedance 2.0 Fast, excelente custo-benefício, aceita referências de áudio, vídeo, texto e imagem
  • jimeng-video-3.5-pro: Seedance 1.5 Pro, áudio e imagem gerados juntos, nova experiência
  • jimeng-video-3.0-pro: Seedance 1.0, melhor resultado, qualidade ultra nítida
  • jimeng-video-3.0-fast: Seedance 1.0 Fast, desempenho nível Pro, mais recursos pelo mesmo preço (padrão)
  • jimeng-video-3.0: Seedance 1.0 mini, resposta precisa, suporta múltiplos planos e movimentos de câmera

Modelo personalizado: se os nomes de modelo predefinidos acima não atenderem às necessidades, você pode informar diretamente o model_req_key original da API Jimeng como valor do parâmetro model; o servidor o repassará diretamente à API. Por exemplo: "model": "high_aes_general_v50".

Implementação técnica

  • Chama diretamente a API oficial do Jimeng, sem serviços de terceiros
  • Engenharia reversa do fluxo de chamadas da API, implementando o processo completo de geração de imagens
  • Suporta resgate e uso automático de créditos
  • Baseado em design orientado a objetos, com a implementação da API encapsulada em classes
  • Retorna uma lista de URLs de imagens de alta qualidade
  • Suporta upload de imagens, processamento automático de imagens locais/da web e alternância automática para o modelo de mistura
  • Na mistura de imagens, faz upload automático da imagem para a nuvem do Jimeng, com fluxo totalmente automatizado

Exemplo de uso

Chamando a função de geração de imagens pelo protocolo MCP:

// 生成图像（文本生成）
client.callTool({
  name: "generateImage",
  arguments: {
    prompt: "一只可爱的猫咪在草地上",
    model: "jimeng-5.0",
    width: 1024,
    height: 1024,
    sample_strength: 0.7,
    negative_prompt: "模糊，扭曲，低质量"
  }
});

// 生成图像（图片混合/参考图生成）
client.callTool({
  name: "generateImage",
  arguments: {
    prompt: "未来城市",
    filePath: "https://example.com/your-image.png"
  }
});

Formato de resposta

A API retorna um array de URLs de imagens geradas, que podem ser exibidas diretamente em diversos clientes:

[
  "https://example.com/generated-image-1.jpg",
  "https://example.com/generated-image-2.jpg",
  "https://example.com/generated-image-3.jpg",
  "https://example.com/generated-image-4.jpg"
]

Recursos

O servidor também oferece os seguintes recursos de informação:

  • greeting://{name} - Fornece uma saudação personalizada
  • info://server - Fornece informações básicas do servidor
  • jimeng-ai://info - Fornece instruções de uso do serviço de geração de imagens Jimeng AI

Dicas de uso no Cursor ou Claude

No Cursor ou no Claude, você pode usar o serviço de geração de imagens Jimeng da seguinte forma:

  1. Certifique-se de que o servidor MCP está configurado
  2. Peça ao Claude/Cursor para gerar uma imagem, por exemplo: 
    请生成一张写实风格的日落下的山脉图片
  3. O Claude/Cursor chamará o servidor MCP Jimeng para gerar a imagem e exibi-la

Perguntas frequentes

  1. Falha na geração de imagem

    • Verifique se o JIMENG_API_TOKEN está configurado corretamente
    • Faça login no site oficial do Jimeng e verifique se há créditos suficientes na conta
    • Tente alterar o prompt, evitando conteúdo sensível
    • No caso de mistura de imagens, verifique se o caminho/URL do filePath é válido e se a imagem está acessível
    • Para imagens da web, use links diretos https para evitar problemas de hotlink/permissões

  2. O servidor não inicia

    • Certifique-se de que todas as dependências estão instaladas
    • Certifique-se de que as variáveis de ambiente estão configuradas corretamente
    • Verifique se a versão do Node.js é 14.0 ou superior

Geração de vídeo Jimeng AI

Este servidor MCP integra a API de geração de vídeo do Jimeng AI, oferecendo a ferramenta de geração de vídeo:

generateVideo - Envia a solicitação de geração de vídeo e retorna a URL do vídeo

  • Parâmetros:
    • prompt: descrição textual do vídeo a ser gerado (obrigatório)
    • filePath: caminhos das imagens do quadro inicial e final, aceita array com no máximo 2 elementos, sendo o primeiro o quadro inicial e o segundo o quadro final (opcional)
    • model: nome do modelo, valores possíveis: jimeng-video-seedance-2.0, jimeng-video-seedance-2.0-fast, jimeng-video-3.5-pro, jimeng-video-3.0-pro, jimeng-video-3.0-fast, jimeng-video-3.0, padrão: jimeng-video-3.0-fast (opcional)
    • resolution: resolução, opções: 720p ou 1080p, padrão: 720p (opcional)
    • width: largura do vídeo, valor padrão: 1024 (opcional)
    • height: altura do vídeo, valor padrão: 1024 (opcional)
    • refresh_token: token da API Jimeng (opcional, normalmente lido da variável de ambiente)
    • req_key: parâmetros personalizados, compatível com interfaces antigas (opcional)

Observação:

  • filePath aceita caminhos absolutos/relativos locais e URLs de imagem.
  • Se filePath for especificado, é possível gerar vídeos com quadros inicial/final personalizados.
  • Imagens da web devem ser publicamente acessíveis.

Exemplo de uso

Chamando a função de geração de vídeo pelo protocolo MCP:

// 生成视频（文本生成）
client.callTool({
  name: "generateVideo",
  arguments: {
    prompt: "一只小狗在草地上奔跑，阳光明媚，高清",
    model: "jimeng-video-3.0-fast",
    resolution: "720p",
    width: 1024,
    height: 1024
  }
});

// 生成视频（首帧/尾帧定制）
client.callTool({
  name: "generateVideo",
  arguments: {
    prompt: "城市夜景延时摄影",
    filePath: ["./first.png", "./last.png"],
    resolution: "1080p"
  }
});

Formato de resposta de vídeo

A API retorna uma string com a URL do vídeo gerado, que pode ser reproduzida diretamente em diversos clientes:

"https://example.com/generated-video.mp4"

Suporte à inicialização do serviço de API

Para iniciar no modo de serviço de API (adequado para chamadas via interface HTTP):

cp .env.example .env   # 复制环境变量模板
# 根据需要编辑.env，填写JIMENG_API_TOKEN等配置

# 启动API服务
yarn start:api

Após a inicialização, o serviço de API ficará ouvindo na porta configurada, permitindo chamadas via interface HTTP para as funções de geração de imagens e vídeos do Jimeng AI.

Licença

MIT