Jimeng MCP Server

Un servidor MCP que se integra con el servicio de generación de imágenes Jimeng AI.

GitHub
53
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Jimeng

Proyecto de servidor Model Context Protocol (MCP) implementado en TypeScript, que integra el servicio de generación de imágenes de Jimeng AI mediante ingeniería inversa para llamar directamente a la API oficial de Jimeng.

Características

  • Construido con TypeScript
  • Usa tsup como herramienta de compilación
  • Implementa el protocolo MCP con soporte de comunicación estándar stdio
  • Llama directamente al servicio de generación de imágenes de Jimeng AI, sin necesidad de API de terceros
  • Proporciona herramientas de generación de imágenes para múltiples modelos de Jimeng
  • Soporta ajuste de varios parámetros de imagen, como tamaño, fineza, indicaciones negativas, etc.
  • Soporta mezcla de imágenes / generación con imagen de referencia (a través del parámetro filePath, compatible con imágenes locales y en línea)
  • Soporta generación de video, con opción de agregar imágenes de referencia (fotogramas inicial y final configurados mediante el parámetro filePath)

Instalación

Instalación mediante Smithery

Para instalar automáticamente jimeng-mcp para Claude Desktop a través de Smithery, ejecute el siguiente comando:

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

Instalación manual

# 使用yarn安装依赖
yarn install

# 或使用npm安装依赖
npm install

Configuración de entorno

Configure las siguientes variables de entorno en la configuración del cliente MCP (como Claude Desktop):

Vaya al proyecto alojado en Smithery, haga clic en json, complete JIMENG_API_TOKEN, haga clic en connect y genere el siguiente json de configuración de mcpServers:

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

Obtener JIMENG_API_TOKEN

  1. Visite el sitio oficial de Jimeng AI e inicie sesión con su cuenta
  2. Presione F12 para abrir las herramientas de desarrollador del navegador
  3. En Application > Cookies, busque el valor de sessionid
  4. Configure el valor de sessionid encontrado como la variable de entorno JIMENG_API_TOKEN

Rotación de múltiples tokens: Se admite la configuración de varios tokens separados por comas en inglés. El servidor los usará en rotación, ideal para balanceo de carga con múltiples cuentas.

JIMENG_API_TOKEN=token1,token2,token3

Desarrollo

# 开发模式运行
yarn dev

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

Compilación

# 构建项目
yarn build

Ejecución

# 启动服务器
yarn start

# 测试MCP服务器
yarn test

Ejemplo de configuración en Claude Desktop

A continuación se muestra un ejemplo completo de configuración de este servidor MCP en Claude Desktop:

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

Generación de imágenes con Jimeng AI

Este servidor MCP llama directamente a la API de generación de imágenes de Jimeng AI y proporciona la herramienta de generación de imágenes:

generateImage - Envía una solicitud de generación de imágenes y devuelve una lista de URLs de imágenes

  • Parámetros:
    • prompt: Descripción textual de la imagen a generar (obligatorio)
    • filePath: Ruta de imagen local o URL de imagen (opcional; si se completa, activa la función de mezcla de imágenes / generación con imagen de referencia)
    • model: Nombre del modelo, valores posibles: jimeng-5.0, jimeng-4.6, jimeng-4.5, jimeng-4.1, jimeng-4.0, jimeng-3.1, jimeng-3.0 (opcional, por defecto jimeng-5.0; al mezclar imágenes cambia automáticamente a jimeng-3.0)
    • width: Ancho de la imagen, valor predeterminado: 1024 (opcional)
    • height: Alto de la imagen, valor predeterminado: 1024 (opcional)
    • sample_strength: Fineza, valor predeterminado: 0.5, rango 0-1 (opcional)
    • negative_prompt: Indicación negativa, indica al modelo qué contenido no generar (opcional)

Nota:

  • filePath admite rutas absolutas/relativas locales y URLs de imágenes.
  • Si se especifica filePath, se activa automáticamente el modo de mezcla de imágenes / generación con imagen de referencia, y el modelo subyacente cambia automáticamente a jimeng-2.0-pro.
  • Las imágenes en línea deben ser de acceso público.

Función de mezcla de imágenes / generación con imagen de referencia

Para generar imágenes basadas en una imagen existente, simplemente pase el parámetro filePath (admite rutas locales o URLs de imágenes) para lograr fusión de estilos, generación con referencia y otras funciones avanzadas.

Ejemplo:

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

o

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

Modelos compatibles

El servidor admite los siguientes modelos de Jimeng AI:

  • Modelos de imagen (basados en Seedream)
  • jimeng-5.0: Seedream 5.0 Lite, respuesta más precisa a instrucciones y resultados más inteligentes (predeterminado)
  • jimeng-4.6: Seedream 4.6, mejor consistencia de retratos y mayor relación calidad-precio
  • jimeng-4.5: Seedream 4.5, consistencia, estilo y respuesta texto-imagen reforzados
  • jimeng-4.1: Seedream 4.0 Design, creatividad, estética y consistencia más profesionales
  • jimeng-4.0: Seedream 4.0, admite múltiples imágenes de referencia y generación de series
  • jimeng-3.1: Seedream 3.0, rica diversidad estética, imágenes más vívidas y nítidas
  • jimeng-3.0: Seedream 3.0, textura cinematográfica, texto más preciso, salida directa en 2k HD
  • Modelos antiguos (compatibilidad hacia atrás): jimeng-2.1, jimeng-2.0-pro, jimeng-2.0, jimeng-1.4, jimeng-xl-pro
  • Modelos de video (basados en Seedance)
  • jimeng-video-seedance-2.0: Seedance 2.0, el rey todoterreno, referencia de audio, video, texto e imagen
  • jimeng-video-seedance-2.0-fast: Seedance 2.0 Fast, alta relación calidad-precio, referencia de audio, video, texto e imagen
  • jimeng-video-3.5-pro: Seedance 1.5 Pro, audio e imagen simultáneos, nueva experiencia
  • jimeng-video-3.0-pro: Seedance 1.0, mejor efecto, calidad ultra HD
  • jimeng-video-3.0-fast: Seedance 1.0 Fast, rendimiento de nivel Pro, más por el mismo precio (predeterminado)
  • jimeng-video-3.0: Seedance 1.0 mini, respuesta precisa, admite múltiples tomas y movimientos de cámara

Modelo personalizado: Si los nombres de modelos predefinidos no son suficientes, puede pasar directamente el model_req_key original de la API de Jimeng como valor del parámetro model; el servidor lo transmitirá directamente a la API. Por ejemplo: "model": "high_aes_general_v50".

Implementación técnica

  • Llama directamente a la API oficial de Jimeng, sin servicios de terceros
  • Ingeniería inversa del flujo de llamadas a la API para lograr el proceso completo de generación de imágenes
  • Admite la obtención y uso automático de créditos
  • Diseño orientado a objetos, encapsulando la implementación de la API en clases
  • Devuelve una lista de URLs de imágenes de alta calidad
  • Admite carga de imágenes, procesamiento automático de imágenes locales/en línea y cambio automático al modelo de mezcla
  • Al mezclar imágenes, las sube automáticamente a la nube de Jimeng; proceso totalmente automatizado

Ejemplo de uso

Llamada a la función de generación de imágenes mediante el 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 respuesta

La API devuelve un array de URLs de imágenes generadas, que se pueden mostrar directamente en varios 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

El servidor también proporciona los siguientes recursos de información:

  • greeting://{name} - Proporciona un saludo personalizado
  • info://server - Proporciona información básica del servidor
  • jimeng-ai://info - Proporciona instrucciones de uso del servicio de generación de imágenes de Jimeng AI

Consejos de uso con Cursor o Claude

En Cursor o Claude, puede usar el servicio de generación de imágenes de Jimeng de la siguiente manera:

  1. Asegúrese de que el servidor MCP esté configurado
  2. Indique a Claude/Cursor que genere una imagen, por ejemplo: 
    请生成一张写实风格的日落下的山脉图片
  3. Claude/Cursor llamará al servidor MCP de Jimeng para generar la imagen y mostrarla

Preguntas frecuentes

  1. Error en la generación de imágenes

    • Verifique que JIMENG_API_TOKEN esté configurado correctamente
    • Inicie sesión en el sitio oficial de Jimeng y compruebe que la cuenta tenga créditos suficientes
    • Intente cambiar la indicación para evitar contenido sensible
    • Si es mezcla de imágenes, verifique que la ruta/URL de filePath sea válida y que la imagen sea accesible
    • Para imágenes en línea, se recomienda usar enlaces directos https para evitar problemas de enlaces protegidos/permisos

  2. El servidor no puede iniciarse

    • Asegúrese de que todas las dependencias estén instaladas
    • Asegúrese de que las variables de entorno estén configuradas correctamente
    • Verifique que la versión de Node.js sea 14.0 o superior

Generación de video con Jimeng AI

Este servidor MCP integra la API de generación de video de Jimeng AI y proporciona la herramienta de generación de video:

generateVideo - Envía una solicitud de generación de video y devuelve la URL del video

  • Parámetros:
    • prompt: Descripción textual del video a generar (obligatorio)
    • filePath: Rutas de imágenes de fotograma inicial y final, admite arrays, máximo 2 elementos: primero el inicial y luego el final (opcional)
    • model: Nombre del modelo, valores posibles: 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; por defecto jimeng-video-3.0-fast (opcional)
    • resolution: Resolución, 720p o 1080p, por defecto 720p (opcional)
    • width: Ancho del video, valor predeterminado: 1024 (opcional)
    • height: Alto del video, valor predeterminado: 1024 (opcional)
    • refresh_token: Token de la API de Jimeng (opcional, normalmente se lee de la variable de entorno)
    • req_key: Parámetros personalizados, compatibles con interfaces antiguas (opcional)

Nota:

  • filePath admite rutas absolutas/relativas locales y URLs de imágenes.
  • Si se especifica filePath, se puede generar video con fotogramas inicial/final personalizados.
  • Las imágenes en línea deben ser de acceso público.

Ejemplo de uso

Llamada a la función de generación de video mediante el 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 respuesta de video

La API devuelve una cadena con la URL del video generado, que se puede reproducir directamente en varios clientes:

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

Soporte para iniciar como servicio API

Para iniciar como servicio API (adecuado para llamadas mediante interfaz HTTP):

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

# 启动API服务
yarn start:api

Una vez iniciado el servicio API, escuchará en el puerto configurado y admitirá llamadas HTTP para la generación de imágenes y videos de Jimeng AI.

Licencia

MIT