Markdown Downloader

Servidor MCP Markdown Downloader

Visão Geral

O Markdown Downloader é um poderoso servidor MCP (Model Context Protocol) que permite baixar páginas da web como arquivos markdown com facilidade. Utilizando o serviço r.jina.ai, esta ferramenta oferece uma maneira integrada de converter conteúdo web em formato markdown.

Recursos

• 🌐 Baixe páginas da web como markdown usando r.jina.ai
• 📁 Diretório de download configurável
• 📝 Gera automaticamente nomes de arquivo com data
• 🔍 Liste arquivos markdown baixados
• 💾 Configuração persistente

Pré-requisitos

• Node.js (versão 16 ou superior)
• npm (Node Package Manager)

Instalação

Instalando via Smithery

Para instalar o Markdown Downloader para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @dazeb/markdown-downloader --client claude

Instalando manualmente

1. Clone o repositório:

   git clone https://github.com/your-username/markdown-downloader.git
   cd markdown-downloader
   

2. Instale as dependências:

   npm install
   

3. Compile o projeto:

   npm run build
   

Adicionar Manualmente o Servidor ao Arquivo de Configurações MCP do Cline/Roo-Cline

Linux/macOS

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
      ]
    }
  }
}

Windows

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
      ]
    }
  }
}

Ferramentas e Uso

1. Definir Diretório de Download

Altere o diretório de download:

use set_download_directory /path/to/your/local/download/folder

• Valida se o diretório existe e é gravável
• Persiste a configuração para uso futuro

2. Baixar Markdown

Baixe uma página da web como arquivo markdown:

use tool download_markdown https://example.com/blog-post

• A URL será prefixada com r.jina.ai
• Formato do nome do arquivo: {sanitized-url}-{date}.md
• Salvo no diretório de download configurado

3. Listar Arquivos Baixados

Liste todos os arquivos markdown baixados:

use list_downloaded_files

4. Obter Diretório de Download

Recupere o diretório de download atual:

use get_download_directory

Configuração

Linux/macOS

• A configuração é armazenada em ~/.config/markdown-downloader/config.json
• Diretório de download padrão: ~/.markdown-downloads

Windows

• A configuração é armazenada em %APPDATA%\markdown-downloader\config.json
• Diretório de download padrão: %USERPROFILE%\Documents\markdown-downloads

Solução de Problemas

• Certifique-se de ter uma conexão ativa com a internet
• Verifique se a URL é válida e acessível
• Confirme as permissões de escrita para o diretório de download

Segurança

• A ferramenta usa r.jina.ai para buscar conteúdo markdown
• Arquivos locais são salvos com nomes de arquivo sanitizados
• O diretório de download configurável permite flexibilidade

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Aviso Legal

Esta ferramenta é fornecida como está. Sempre revise o conteúdo baixado quanto à precisão e adequação.

Suporte

Para problemas ou solicitações de recursos, abra uma issue no repositório do GitHub.