mcp_3d_relief

Generador de relieve 3D MCP STL

中文· Introducción a MCP · Wiki

Este proyecto proporciona un servidor MCP que convierte imágenes 2D en modelos de relieve 3D en formato STL, adecuados para impresión o renderizado 3D.

Características

• Convierte cualquier imagen en un modelo de relieve 3D
• Dimensiones del modelo de control (ancho, grosor)
• Añadir base opcional al modelo 3D
• Invertir profundidad para obtener diferentes efectos de relieve
• Procesamiento rápido con enlaces de descarga inmediata

Instalación

Prerrequisitos

• Python 3.10+
• ultravioleta

Opción 1: Instalación local

1. Clonar el repositorio:

2. Instalar dependencias:

3. Ejecutar/Inspeccionar el servidor:

Uso

Configuración JSON

Parámetros de la herramienta MCP

• image_path : Ruta local o URL web al archivo de imagen de entrada
• model_width : Ancho del modelo 3D en mm (predeterminado: 50,0)
• model_thickness : Grosor/altura máximos del modelo 3D en mm (valor predeterminado: 5,0)
• base_thickness : Espesor de la base en mm (predeterminado: 2.0)
• skip_depth : si se utilizará la imagen directamente o se generará un mapa de profundidad (valor predeterminado: verdadero)
• invert_depth : Invierte el relieve (las áreas brillantes se vuelven bajas en lugar de altas) (predeterminado: falso)
• detail_level : Controla la resolución de la imagen procesada (predeterminado: 1.0). Con detail_level = 1.0, la imagen se procesa a una resolución de 320 px, lo que genera un archivo STL que normalmente ocupa menos de 100 MB. Valores más altos mejoran la calidad del detalle, pero aumentan significativamente el tiempo de procesamiento y el tamaño del archivo STL. Por ejemplo, duplicar detail_level puede aumentar el tamaño del archivo 4 veces o más. Úselo con precaución.

Respuesta

La herramienta MCP devuelve una respuesta JSON con:

Dónde los LLM pueden acceder a los archivos generados desde este servidor MCP, utilizando las URL proporcionadas.

Línea de comandos

También puedes utilizar el script directamente desde la línea de comandos para generar un modelo de relieve a partir de una imagen:

Generación de mapas de profundidad externos

Para obtener mapas de profundidad de mayor calidad, puede usar servicios externos de generación de mapas de profundidad como Depth-Anything-V2 . Este servicio puede generar mapas de profundidad más precisos que puede usar en este proyecto:

1. Visita https://huggingface.co/spaces/depth-anything/Depth-Anything-V2
2. Sube tu imagen para generar un mapa de profundidad
3. Descargar el mapa de profundidad generado
4. Utilice este mapa de profundidad con nuestro convertidor configurando skip_depth=false

Este enfoque puede proporcionar mejores modelos de relieve 3D, especialmente para imágenes complejas.

Cómo funciona

1. La imagen se procesa para crear un mapa de profundidad (píxeles más oscuros = más bajos, píxeles más brillantes = más altos)
2. El mapa de profundidad se convierte en una malla 3D con facetas triangulares.
3. Se añade una base a la parte inferior del modelo.
4. El modelo se guarda como un archivo STL

Nuestros socios