Drawing Guides

Acesse tutoriais de desenho passo a passo e guias do easydrawingguides.com para artistas de todos os níveis de habilidade.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP Drawing Guides

Um servidor Model Context Protocol (MCP) que fornece acesso a tutoriais e guias de desenho do easydrawingguides.com, facilitando a busca e recuperação de instruções de desenho passo a passo para artistas de todos os níveis de habilidade.

Visão Geral

Este servidor MCP atua como uma ponte entre assistentes de IA e sites populares de tutoriais de desenho, projetado especificamente para:

Busca Abrangente: Pesquise nos Easy Drawing Guides por tutoriais de desenho
Tutoriais Detalhados: Recupere guias de desenho completos com instruções passo a passo
Extração de Conteúdo: Analise e estruture instruções de desenho para fácil consumo
Navegação por Categorias: Navegue pelas categorias e tópicos de desenho disponíveis
Adequado para Famílias: Acesse conteúdo de desenho voltado para crianças e iniciantes

Recursos

🔍 Ferramenta de Busca

Pesquise tutoriais de desenho nos Easy Drawing Guides
Retorna metadados estruturados e uma lista classificada de guias relevantes
Valida todas as URLs retornadas para garantir que estejam acessíveis
Inclui instruções para LLMs sobre como usar URLs exatas com a ferramenta get_guide
Limites de resultados configuráveis

📋 Ferramenta de Recuperação de Guias

Recupere conteúdo completo de tutoriais de desenho de URLs como Markdown
Extraia conteúdo da seção principal do artigo (remove anúncios)
Preserve a formatação e estrutura originais em formato Markdown
Saída limpa e legível com metadados

📚 Ferramenta de Categorias

Liste as categorias de desenho disponíveis nos Easy Drawing Guides
Descubra tópicos e temas populares de desenho
Obtenha sugestões de termos de busca e ideias

Instalação e Configuração

Pré-requisitos

Python 3.12 ou superior
Gerenciador de pacotes uv

Início Rápido

Execute diretamente com uvx (quando publicado):

uvx mcp-drawing-guides

Ou execute a partir do diretório local:

uvx --from . mcp-drawing-guides

Ou instale localmente:

Clone ou baixe este projeto
Instale as dependências:
```
cd mcp-drawing-guides
uv sync
```
Execute o servidor:
```
uv run python main.py
```

Integração com Assistentes de IA

Este servidor MCP foi projetado para funcionar com assistentes de IA que suportam o Model Context Protocol. Configure seu assistente de IA para conectar-se a este servidor via stdio.

Exemplo de configuração para Claude Desktop:

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

Ou se estiver usando uma instalação local:

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

Ferramentas Disponíveis

`search`

Pesquise tutoriais de desenho em sites suportados.

Parâmetros:

query (obrigatório): Termos de busca (ex.: "gato", "personagem de anime", "flor")
limit (opcional): Máximo de resultados a retornar (1-20, padrão: 10)
source (opcional): Qual site pesquisar - "easy" (padrão: "easy")

Retorna:

Metadados da busca (consulta, contagem de resultados, fontes pesquisadas)
Lista de guias de desenho correspondentes com títulos e URLs validadas
Instruções para usar a ferramenta get_guide com URLs exatas dos resultados

Exemplo:

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

`get_guide`

Recupere conteúdo detalhado de um guia de desenho específico.

Parâmetros:

url (obrigatório): URL do guia de desenho do easydrawingguides.com

Retorna:

Metadados do guia (título, fonte, URL, tamanho do conteúdo)
Conteúdo completo do tutorial formatado como Markdown

Exemplo:

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

`list_categories`

Liste as categorias de desenho disponíveis e tópicos populares.

Parâmetros:

Nenhum obrigatório

Retorna:

Categorias dos Easy Drawing Guides
Termos de busca populares e sugestões

Exemplo:

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

Sites Suportados

Easy Drawing Guides (easydrawingguides.com)

Foco: Tutoriais de desenho passo a passo para todos os níveis de habilidade
Conteúdo: Animais, pessoas, plantas, desenhos animados, objetos, anime, videogames
Recursos: Instruções detalhadas, planilhas imprimíveis, tutoriais em vídeo
Público: Crianças, iniciantes e amadores

Como Funciona

Processo de Extração de Conteúdo

Web Scraping: Usa requests e BeautifulSoup para buscar e analisar conteúdo web
Segmentação de Conteúdo: Extrai conteúdo especificamente de <div class="inside-article">
Remoção de Anúncios: Remove elementos <div class="mv-ad-box"> para limpar o conteúdo
Conversão para Markdown: Converte conteúdo HTML para formato Markdown limpo e legível
Geração de Metadados: Cria metadados estruturados para cada guia

Algoritmo de Busca

Busca no Site: Consulta os Easy Drawing Guides por tutoriais relevantes
Classificação por Relevância: Ordena resultados por relevância de palavras-chave nos títulos
Validação de URLs: Valida cada URL para garantir que esteja acessível antes de incluir nos resultados
Filtragem de Conteúdo: Filtra resultados irrelevantes ou duplicados
Atribuição de Fonte: Identifica claramente a fonte de cada resultado

Formato de Saída Estruturada

Todas as ferramentas retornam respostas estruturadas com blocos separados para:

Metadados: Fonte, URL, estatísticas de conteúdo, parâmetros de busca
Conteúdo: Conteúdo principal do tutorial e descrições
Instruções: Instruções de desenho passo a passo quando disponíveis
Referências: URLs de imagens e texto alternativo para referência visual

Casos de Uso

Para Estudantes de Arte e Iniciantes

Encontre tutoriais passo a passo para assuntos específicos
Aprenda técnicas fundamentais de desenho
Acesse instruções amigáveis para iniciantes com passos claros

Para Pais e Professores

Descubra atividades de desenho adequadas para famílias
Encontre projetos de arte apropriados para a idade das crianças
Acesse conteúdo educacional para aulas de arte

Para Artistas Digitais e Amadores

Obtenha inspiração para novos assuntos de desenho
Encontre materiais de referência e guias de instrução
Aprenda novos estilos e técnicas de desenho

Para Criadores de Conteúdo

Fonte de conteúdo de tutorial para educação artística
Encontre processos passo a passo para referência
Acesse dados estruturados de instruções de desenho

Guia de Início Rápido

Clone ou baixe este repositório
Instale as dependências:
```
cd mcp-drawing-guides
uv sync
```
Teste o servidor:
```
uv run python main.py
```
Pressione Ctrl+C para parar o servidor.
Configure seu assistente de IA para usar este servidor MCP

Exemplos

Busca Básica

Pergunte ao seu assistente de IA: "Pesquise tutoriais de desenho sobre cachorros"

O servidor irá:

Pesquisar nos Easy Drawing Guides por "cachorros"
Retornar metadados estruturados (consulta, contagem de resultados, fontes)
Fornecer uma lista de tutoriais relevantes com URLs validadas
Incluir acesso direto aos guias completos

Recuperar Guia Específico

Pergunte ao seu assistente de IA: "Obtenha as instruções detalhadas para este guia de desenho: [URL]"

O servidor irá:

Buscar o conteúdo completo do tutorial da URL
Extrair conteúdo da seção principal do artigo (remove anúncios)
Converter conteúdo HTML para formato Markdown limpo
Retornar metadados estruturados e conteúdo formatado

Navegar por Categorias

Pergunte ao seu assistente de IA: "Quais categorias de desenho estão disponíveis?"

O servidor irá:

Retornar listas organizadas de categorias dos Easy Drawing Guides
Fornecer termos de busca populares e sugestões
Ajudar você a descobrir novos tópicos e temas de desenho

Desenvolvimento

Estrutura do Projeto

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)

Dependências Principais

mcp: Estrutura Model Context Protocol
requests: Biblioteca HTTP para web scraping
beautifulsoup4: Análise de HTML e extração de conteúdo
lxml: Analisador rápido de XML e HTML
markdownify: Conversão de HTML para Markdown

Personalização

O servidor pode ser facilmente personalizado modificando main.py:

Adicionar Novos Sites: Estenda as funções de busca para suportar sites de tutoriais adicionais
Melhorar Análise: Aprimore a extração de conteúdo para melhor identificação de etapas
Filtragem de Conteúdo: Adicione filtros personalizados para qualidade ou adequação do conteúdo
Cache: Implemente cache para melhorar o desempenho e reduzir a carga do servidor

Testando o Servidor

Teste o servidor diretamente:

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

Ou com instalação local:

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

O servidor se comunica via JSON-RPC sobre stdin/stdout, então você precisará de um cliente MCP ou assistente de IA para interagir adequadamente.

Solução de Problemas

Problemas Comuns

Erros de Importação: Certifique-se de que todas as dependências estejam instaladas com uv sync
Problemas de Rede: Verifique a conectividade com a internet para acessar sites de tutoriais
Erros de Análise: Algumas páginas podem ter estruturas diferentes; o servidor lida com isso de forma graciosa
Limitação de Taxa: Seja respeitoso com os recursos do servidor dos sites de origem

Depuração

Ative o registro de depuração modificando o nível de registro em main.py:

logging.basicConfig(level=logging.DEBUG)

Considerações Éticas

Respeito: Este servidor respeita o robots.txt e os termos de serviço dos sites de origem
Atribuição: Todo o conteúdo é devidamente atribuído à sua fonte original
Não Comercial: Destinado a uso educacional e pessoal
Uso Justo: Extrai apenas o conteúdo necessário para fins de tutorial

Contribuindo

Esta é uma implementação simples de arquivo único, projetada para clareza e facilidade de modificação. Sinta-se à vontade para:

Adicionar suporte para sites adicionais de tutoriais de desenho
Melhorar algoritmos de extração de conteúdo
Adicionar cache para melhor desempenho
Estender com recursos adicionais relacionados a desenho

Licença

Este projeto usa a mesma licença de suas dependências. O conteúdo de tutoriais de desenho acessado através deste servidor permanece propriedade dos sites e criadores originais.

Este servidor MCP torna os tutoriais de desenho mais acessíveis, fornecendo acesso estruturado a guias de desenho passo a passo de fontes educacionais confiáveis.