Servidor MCP Fetch | Awesome MCP Servers

Fetch MCP Server

Um servidor MCP para buscar conteúdo da web em vários formatos — HTML, JSON, texto simples, Markdown, conteúdo de artigos legíveis e transcrições do YouTube.

Ferramentas

Todas as ferramentas aceitam os seguintes parâmetros comuns:

Parâmetro	Tipo	Obrigatório	Descrição
`url`	string	Sim	URL a buscar
`headers`	object	Não	Cabeçalhos personalizados para incluir na requisição
`max_length`	number	Não	Máximo de caracteres a retornar (padrão: 5000)
`start_index`	number	Não	Começar a partir deste índice de caractere (padrão: 0)
`proxy`	string	Não	URL do proxy (ex.: `http://proxy:8080`)

fetch_html — Busca um site e retorna o conteúdo HTML bruto.
fetch_markdown — Busca um site e retorna seu conteúdo convertido para Markdown.
fetch_txt — Busca um site e retorna texto simples com tags HTML, scripts e estilos removidos.
fetch_json — Busca uma URL e retorna a resposta JSON.
fetch_readable — Busca um site e extrai o conteúdo principal do artigo usando Mozilla Readability, retornado como Markdown. Remove navegação, anúncios e conteúdo repetitivo. Ideal para artigos e postagens de blog.
fetch_youtube_transcript — Busca legendas/transcrição de um vídeo do YouTube. Usa yt-dlp se disponível, caso contrário extrai diretamente da página. Aceita um parâmetro adicional lang (padrão: "en") para selecionar o idioma das legendas.

Instalação

Como um servidor MCP

Adicione à configuração do seu cliente MCP:

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["mcp-fetch-server"]
    }
  }
}

Como CLI

npx mcp-fetch <command> <url> [flags]

Ou instale globalmente:

npm install -g mcp-fetch-server
mcp-fetch <command> <url> [flags]

Uso via CLI

mcp-fetch <command> <url> [flags]

Comandos

Comando	Descrição
`html`	Busca uma URL e retorna HTML bruto
`markdown`	Busca uma URL e retorna Markdown
`readable`	Busca uma URL e retorna o conteúdo do artigo como Markdown (via Readability)
`txt`	Busca uma URL e retorna texto simples
`json`	Busca uma URL e retorna JSON
`youtube`	Busca a transcrição de um vídeo do YouTube

Flags

Flag	Descrição
`--max-length <N>`	Máximo de caracteres a retornar
`--start-index <N>`	Começar a partir deste índice de caractere
`--proxy <URL>`	URL do proxy
`--lang <code>`	Código de idioma para transcrições do YouTube (padrão: `en`)
`--help`	Mostrar mensagem de ajuda
`--version`	Mostrar versão

Exemplos

# Fetch a page as markdown
mcp-fetch markdown https://example.com

# Extract article content without boilerplate
mcp-fetch readable https://example.com/blog/post

# Get a YouTube transcript in Spanish
mcp-fetch youtube https://www.youtube.com/watch?v=dQw4w9WgXcQ --lang es

# Fetch with a length limit
mcp-fetch html https://example.com --max-length 10000

# Fetch through a proxy
mcp-fetch json https://api.example.com/data --proxy http://proxy:8080

Variáveis de Ambiente

Variável	Descrição
`DEFAULT_LIMIT`	Limite padrão de caracteres para respostas (padrão: `5000`, defina como `0` para sem limite)
`MAX_RESPONSE_BYTES`	Tamanho máximo do corpo da resposta em bytes (padrão: `10485760` / 10 MB)

Exemplo com um limite personalizado:

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["mcp-fetch-server"],
      "env": {
        "DEFAULT_LIMIT": "50000"
      }
    }
  }
}

Recursos

Buscar conteúdo da web como HTML, JSON, texto simples ou Markdown
Extrair o conteúdo do artigo com Mozilla Readability (remove anúncios, navegação, conteúdo repetitivo)
Extrair transcrições de vídeos do YouTube (via yt-dlp ou extração direta)
Suporte a proxy para requisições atrás de firewalls
Paginação com max_length e start_index
Cabeçalhos de requisição personalizados
Proteção SSRF (bloqueia endereços privados/localhost e rebinding de DNS)
Limites de tamanho de resposta para evitar esgotamento de memória

Desenvolvimento

bun install
bun run dev     # start with watch mode
bun test        # run tests
bun run build   # build for production

Licença

Este projeto está licenciado sob a Licença MIT.

Fetch

Documentação