Fetch MCP Server

Web içeriğini birden çok formatta getirmek için bir MCP sunucusu — HTML, JSON, düz metin, Markdown, okunabilir makale içeriği ve YouTube transkriptleri.

Araçlar

Tüm araçlar aşağıdaki ortak parametreleri kabul eder:

Parametre	Tür	Gerekli	Açıklama
url	string	Evet	Getirilecek URL
headers	object	Hayır	İstekte eklenecek özel başlıklar
max_length	number	Hayır	Döndürülecek maksimum karakter (varsayılan: 5000)
start_index	number	Hayır	Bu karakter indeksinden başla (varsayılan: 0)
proxy	string	Hayır	Proxy URL'si (örn. http://proxy:8080)

• fetch_html — Bir web sitesini getir ve ham HTML içeriğini döndür.

• fetch_markdown — Bir web sitesini getir ve içeriğini Markdown'a dönüştürerek döndür.

• fetch_txt — Bir web sitesini getir ve HTML etiketleri, scriptler ve stiller kaldırılmış düz metni döndür.

• fetch_json — Bir URL'yi getir ve JSON yanıtını döndür.

• fetch_readable — Bir web sitesini getir ve ana makale içeriğini Mozilla Readability kullanarak çıkar, Markdown olarak döndür. Navigasyon, reklamlar ve boilerplate'i kaldırır. Makaleler ve blog yazıları için idealdi.

• fetch_youtube_transcript — Bir YouTube videosunun başlıklarını/transkriptini getir. Varsa yt-dlp kullanır, aksi takdirde sayfadan doğrudan çıkarır. Alt yazı dilini seçmek için ek lang parametresini kabul eder (varsayılan: "en").

Kurulum

MCP sunucusu olarak

MCP istemci yapılandırmanıza ekleyin:

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

CLI olarak

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

Veya global olarak yükleyin:

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

CLI Kullanımı

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

Komutlar

Komut	Açıklama
html	Bir URL'yi getir ve ham HTML döndür
markdown	Bir URL'yi getir ve Markdown döndür
readable	Bir URL'yi getir ve makale içeriğini Markdown olarak döndür (Readability aracılığıyla)
txt	Bir URL'yi getir ve düz metin döndür
json	Bir URL'yi getir ve JSON döndür
youtube	Bir YouTube videosunun transkriptini getir

Bayraklar

Bayrak	Açıklama
--max-length <N>	Döndürülecek maksimum karakter
--start-index <N>	Bu karakter indeksinden başla
--proxy <URL>	Proxy URL'si
--lang <code>	YouTube transkriptleri için dil kodu (varsayılan: en)
--help	Yardım mesajını göster
--version	Sürümü göster

Örnekler

# Bir sayfayı markdown olarak getir
mcp-fetch markdown https://example.com

# Boilerplate olmadan makale içeriğini çıkar
mcp-fetch readable https://example.com/blog/post

# YouTube transkriptini İspanyolca olarak al
mcp-fetch youtube https://www.youtube.com/watch?v=dQw4w9WgXcQ --lang es

# Uzunluk sınırıyla getir
mcp-fetch html https://example.com --max-length 10000

# Proxy aracılığıyla getir
mcp-fetch json https://api.example.com/data --proxy http://proxy:8080

Ortam Değişkenleri

Değişken	Açıklama
DEFAULT_LIMIT	Yanıtlar için varsayılan karakter sınırı (varsayılan: 5000, sınır yok için 0 olarak ayarla)
MAX_RESPONSE_BYTES	Maksimum response gövdesi boyutu bayt cinsinden (varsayılan: 10485760 / 10 MB)

Özel sınırla örnek:

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

Özellikler

• Web içeriğini HTML, JSON, düz metin veya Markdown olarak getir
• Mozilla Readability ile makale içeriğini çıkar (reklamları, navigasyonu, boilerplate'i kaldırır)
• YouTube video transkriptlerini çıkar (yt-dlp aracılığıyla veya doğrudan çıkarma)
• Güvenlik duvarının arkasındaki istekler için proxy desteği
• max_length ve start_index ile sayfalandırma
• Özel istek başlıkları
• SSRF koruması (özel/localhost adreslerini ve DNS yeniden bağlamayı engeller)
• Bellek tükenmesini önlemek için response boyutu sınırları

Geliştirme

bun install
bun run dev     # watch modunda başla
bun test        # testleri çalıştır
bun run build   # production için derle

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır.