Drawing Guides

Accede a tutoriales y guías de dibujo paso a paso de easydrawingguides.com para artistas de todos los niveles de habilidad.

Documentación

Servidor MCP de Drawing Guides

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a tutoriales y guías de dibujo de easydrawingguides.com, facilitando la búsqueda y recuperación de instrucciones de dibujo paso a paso para artistas de todos los niveles de habilidad.

Descripción general

Este servidor MCP actúa como un puente entre asistentes de IA y sitios web populares de tutoriales de dibujo, diseñado específicamente para:

  • Búsqueda integral: Busca en Easy Drawing Guides tutoriales de dibujo
  • Tutoriales detallados: Recupera guías de dibujo completas con instrucciones paso a paso
  • Extracción de contenido: Analiza y estructura instrucciones de dibujo para facilitar su consumo
  • Navegación por categorías: Explora categorías y temas de dibujo disponibles
  • Apto para familias: Accede a contenido de dibujo para niños y principiantes

Características

🔍 Herramienta de búsqueda

  • Busca tutoriales de dibujo en Easy Drawing Guides
  • Devuelve metadatos estructurados y una lista clasificada de guías relevantes
  • Valida todas las URLs devueltas para garantizar su accesibilidad
  • Incluye instrucciones para LLMs sobre cómo usar URLs exactas con la herramienta get_guide
  • Límites de resultados configurables

📋 Herramienta de recuperación de guías

  • Recupera contenido completo de tutoriales de dibujo desde URLs como Markdown
  • Extrae contenido de la sección principal del artículo (elimina anuncios)
  • Preserva el formato y la estructura originales en formato Markdown
  • Salida limpia y legible con metadatos

📚 Herramienta de categorías

  • Lista las categorías de dibujo disponibles en Easy Drawing Guides
  • Descubre temas y estilos de dibujo populares
  • Obtén sugerencias para términos de búsqueda e ideas

Instalación y configuración

Requisitos previos

  • Python 3.12 o superior
  • Gestor de paquetes uv

Inicio rápido

Ejecutar directamente con uvx (una vez publicado):

uvx mcp-drawing-guides

O ejecutar desde el directorio local:

uvx --from . mcp-drawing-guides

O instalar localmente:

  1. Clona o descarga este proyecto

  2. Instala las dependencias:

    cd mcp-drawing-guides
    uv sync
    
  3. Ejecuta el servidor:

    uv run python main.py
    

Integración con asistentes de IA

Este servidor MCP está diseñado para funcionar con asistentes de IA que admitan el Protocolo de Contexto de Modelo. Configura tu asistente de IA para conectarse a este servidor mediante stdio.

Ejemplo de configuración para Claude Desktop:

{
  "mcpServers": {
    "drawing-guides": {
      "command": "uvx",
      "args": ["--from", "/path/to/mcp-drawing-guides", "mcp-drawing-guides"]
    }
  }
}

O si se utiliza una instalación local:

{
  "mcpServers": {
    "drawing-guides": {
      "command": "uv",
      "args": ["run", "python", "/path/to/mcp-drawing-guides/main.py"]
    }
  }
}

Herramientas disponibles

search

Busca tutoriales de dibujo en sitios compatibles.

Parámetros:

  • query (obligatorio): Términos de búsqueda (p. ej., "gato", "personaje anime", "flor")
  • limit (opcional): Máximo de resultados a devolver (1-20, predeterminado: 10)
  • source (opcional): Sitio a buscar - "easy" (predeterminado: "easy")

Devuelve:

  • Metadatos de búsqueda (consulta, número de resultados, fuentes consultadas)
  • Lista de guías de dibujo coincidentes con títulos y URLs validadas
  • Instrucciones para usar la herramienta get_guide con URLs exactas de los resultados

Ejemplo:

{
  "name": "search",
  "arguments": {
    "query": "cute cat",
    "limit": 5,
    "source": "easy"
  }
}

get_guide

Recupera el contenido detallado de una guía de dibujo específica.

Parámetros:

  • url (obligatorio): URL de la guía de dibujo de easydrawingguides.com

Devuelve:

  • Metadatos de la guía (título, fuente, URL, longitud del contenido)
  • Contenido completo del tutorial formateado como Markdown

Ejemplo:

{
  "name": "get_guide",
  "arguments": {
    "url": "https://easydrawingguides.com/draw-cat/"
  }
}

list_categories

Lista las categorías de dibujo disponibles y los temas populares.

Parámetros:

  • Ninguno requerido

Devuelve:

  • Categorías de Easy Drawing Guides
  • Términos de búsqueda y sugerencias populares

Ejemplo:

{
  "name": "list_categories",
  "arguments": {}
}

Sitios compatibles

Easy Drawing Guides (easydrawingguides.com)

  • Enfoque: Tutoriales de dibujo paso a paso para todos los niveles de habilidad
  • Contenido: Animales, personas, plantas, dibujos animados, objetos, anime, videojuegos
  • Características: Instrucciones detalladas, hojas de trabajo imprimibles, tutoriales en video
  • Audiencia: Niños, principiantes y aficionados

Cómo funciona

Proceso de extracción de contenido

  1. Web Scraping: Utiliza requests y BeautifulSoup para obtener y analizar contenido web
  2. Segmentación de contenido: Extrae contenido específicamente de <div class="inside-article">
  3. Eliminación de anuncios: Elimina elementos de <div class="mv-ad-box"> para limpiar el contenido
  4. Conversión a Markdown: Convierte contenido HTML a formato Markdown limpio y legible
  5. Generación de metadatos: Crea metadatos estructurados para cada guía

Algoritmo de búsqueda

  1. Búsqueda en el sitio: Consulta Easy Drawing Guides para tutoriales relevantes
  2. Clasificación por relevancia: Ordena los resultados por relevancia de palabras clave en los títulos
  3. Validación de URLs: Valida cada URL para garantizar su accesibilidad antes de incluirla en los resultados
  4. Filtrado de contenido: Filtra resultados irrelevantes o duplicados
  5. Atribución de fuente: Identifica claramente la fuente de cada resultado

Formato de salida estructurado

Todas las herramientas devuelven respuestas estructuradas con bloques separados para:

  • Metadatos: Fuente, URL, estadísticas de contenido, parámetros de búsqueda
  • Contenido: Contenido principal del tutorial y descripciones
  • Instrucciones: Instrucciones de dibujo paso a paso cuando estén disponibles
  • Referencias: URLs de imágenes y texto alternativo para referencia visual

Casos de uso

Para estudiantes de arte y principiantes

  • Encuentra tutoriales paso a paso para temas específicos
  • Aprende técnicas fundamentales de dibujo
  • Accede a instrucciones aptas para principiantes con pasos claros

Para padres y maestros

  • Descubre actividades de dibujo aptas para familias
  • Encuentra proyectos de arte apropiados para la edad de los niños
  • Accede a contenido educativo para clases de arte

Para artistas digitales y aficionados

  • Obtén inspiración para nuevos temas de dibujo
  • Encuentra materiales de referencia y guías de instrucción
  • Aprende nuevos estilos y técnicas de dibujo

Para creadores de contenido

  • Obtén contenido de tutoriales para educación artística
  • Encuentra procesos paso a paso como referencia
  • Accede a datos estructurados de instrucciones de dibujo

Guía de inicio rápido

  1. Clona o descarga este repositorio

  2. Instala las dependencias:

    cd mcp-drawing-guides
    uv sync
    
  3. Prueba el servidor:

    uv run python main.py
    

    Presiona Ctrl+C para detener el servidor.

  4. Configura tu asistente de IA para usar este servidor MCP

Ejemplos

Búsqueda básica

Pregunta a tu asistente de IA: "Busca tutoriales de dibujo sobre perros"

El servidor:

  1. Buscará "perros" en Easy Drawing Guides
  2. Devolverá metadatos estructurados (consulta, número de resultados, fuentes)
  3. Proporcionará una lista de tutoriales relevantes con URLs validadas
  4. Incluirá acceso directo a las guías completas

Recuperar una guía específica

Pregunta a tu asistente de IA: "Obtén las instrucciones detalladas de esta guía de dibujo: [URL]"

El servidor:

  1. Obtendrá el contenido completo del tutorial desde la URL
  2. Extraerá el contenido de la sección principal del artículo (elimina anuncios)
  3. Convertirá el contenido HTML a formato Markdown limpio
  4. Devolverá metadatos estructurados y contenido formateado

Explorar categorías

Pregunta a tu asistente de IA: "¿Qué categorías de dibujo están disponibles?"

El servidor:

  1. Devolverá listas organizadas de categorías de Easy Drawing Guides
  2. Proporcionará términos de búsqueda y sugerencias populares
  3. Ayudará a descubrir nuevos temas y estilos de dibujo

Desarrollo

Estructura del proyecto

mcp-drawing-guides/
├── main.py          # Main MCP server implementation
├── pyproject.toml   # Project dependencies and metadata
├── README.md        # This documentation
└── .venv/           # Virtual environment (created by uv)

Dependencias clave

  • mcp: Marco de trabajo del Protocolo de Contexto de Modelo
  • requests: Biblioteca HTTP para web scraping
  • beautifulsoup4: Análisis de HTML y extracción de contenido
  • lxml: Analizador rápido de XML y HTML
  • markdownify: Conversión de HTML a Markdown

Personalización

El servidor se puede personalizar fácilmente modificando main.py:

  • Agregar nuevos sitios: Extiende las funciones de búsqueda para admitir sitios de tutoriales adicionales
  • Mejorar el análisis: Mejora la extracción de contenido para una mejor identificación de pasos
  • Filtrado de contenido: Agrega filtros personalizados para calidad o idoneidad del contenido
  • Caché: Implementa caché para mejorar el rendimiento y reducir la carga del servidor

Prueba del servidor

Prueba el servidor directamente:

cd mcp-drawing-guides
uvx --from . mcp-drawing-guides

O con instalación local:

cd mcp-drawing-guides
uv run python main.py

El servidor se comunica mediante JSON-RPC a través de stdin/stdout, por lo que necesitarás un cliente MCP o un asistente de IA para interactuar correctamente con él.

Solución de problemas

Problemas comunes

  1. Errores de importación: Asegúrate de que todas las dependencias estén instaladas con uv sync
  2. Problemas de red: Verifica la conectividad a Internet para acceder a los sitios de tutoriales
  3. Errores de análisis: Algunas páginas pueden tener estructuras diferentes; el servidor maneja esto correctamente
  4. Limitación de velocidad: Sé respetuoso con los recursos del servidor de los sitios fuente

Depuración

Habilita el registro de depuración modificando el nivel de registro en main.py:

logging.basicConfig(level=logging.DEBUG)

Consideraciones éticas

  • Respeto: Este servidor respeta el robots.txt y los términos de servicio de los sitios fuente
  • Atribución: Todo el contenido se atribuye correctamente a su fuente original
  • Uso no comercial: Destinado a uso educativo y personal
  • Uso justo: Extrae solo el contenido necesario para fines de tutoriales

Contribuciones

Esta es una implementación simple de un solo archivo diseñada para claridad y facilidad de modificación. Siéntete libre de:

  • Agregar soporte para sitios adicionales de tutoriales de dibujo
  • Mejorar los algoritmos de extracción de contenido
  • Agregar caché para un mejor rendimiento
  • Extender con características adicionales relacionadas con el dibujo

Licencia

Este proyecto utiliza la misma licencia que sus dependencias. El contenido de tutoriales de dibujo al que se accede a través de este servidor sigue siendo propiedad de los sitios y creadores originales.


Este servidor MCP hace que los tutoriales de dibujo sean más accesibles al proporcionar acceso estructurado a guías de dibujo paso a paso de fuentes educativas confiables.