web-basics-mcp

Kleine, zuverlässige Web-Werkzeuge für Agenten. Keine API-Schlüssel und keine gebündelte Infrastruktur.

Werkzeuge

fetch_url gibt sauberen Markdown für HTML-Seiten und Reddit-Beiträge zurück, auswählbaren Text für PDFs, direkten Inhalt für Text-/Markdown-/JSON-/XML-Antworten und native MCP-Bildinhalte für PNG-, JPEG-, WebP- und GIF-Bilder.

Langer Text wird in begrenzten Blöcken gelesen. Rufen Sie dieselbe URL erneut mit dem zurückgegebenen next_start_index auf:

{
  "url": "https://example.com/long-page",
  "start_index": 8000,
  "max_length": 8000
}

Erfolgreiche Abrufe werden fünf Minuten lang im Arbeitsspeicher zwischengespeichert, sodass Offset-Lesevorgänge normalerweise dasselbe extrahierte Dokument verwenden. Suchergebnisse werden zwei Minuten lang zwischengespeichert, um während einer Agentenausführung identische SearXNG-Arbeit zu vermeiden. Beide Caches sind begrenzt, fassen gleichzeitige doppelte Anfragen zusammen und können jederzeit verworfen werden; die Korrektheit der Werkzeuge hängt niemals von ihnen ab.

Related MCP server: Basic MCP Tools

Voraussetzungen

• Node.js 20.18.1 oder neuer

• Eine bestehende SearXNG-Instanz mit aktivierten JSON-Antworten

Legen Sie die Basis-URL in der Umgebung oder in der .env-Datei dieses Pakets fest:

SEARXNG_URL=http://127.0.0.1:8088

Der Server startet auch dann, wenn SearXNG nicht verfügbar ist, sodass fetch_url weiterhin nutzbar bleibt. Aufrufe von web_search geben einen klaren Verbindungsfehler zurück, bis SearXNG erreichbar ist.

Installation

git clone https://github.com/yoloyash/web-basics-mcp.git
cd web-basics-mcp
npm install
npm run build

Konfigurieren Sie einen MCP-Client, um build/index.js über stdio auszuführen. Beispiel:

codex mcp add web-basics -- node /absolute/path/to/web-basics-mcp/build/index.js

Werkzeug-Eingaben

web_search

{
  "query": "Model Context Protocol",
  "limit": 5
}

limit ist standardmäßig 5 und akzeptiert Werte von 1 bis 10. Ergebnisse verwenden die stabile Form {link, title, snippet}.

fetch_url

{
  "url": "https://example.com",
  "start_index": 0,
  "max_length": 8000
}

• start_index ist standardmäßig 0.

• max_length ist standardmäßig 8000 und auf 20000 begrenzt.

• Textantworten melden total_chars, returned_chars, truncated und, wenn mehr Inhalt vorhanden ist, next_start_index.

• HTML verwendet zuerst Defuddle und Mozilla Readability als gesteuerten Fallback. Die Antwort meldet den ausgewählten extractor und gegebenenfalls den Fallback-Grund.

• Defuddles optionale netzwerkgestützte Extrakteure sind deaktiviert. Jede entfernte Anfrage bleibt im validierten HTTP-Pfad dieses Servers.

• Reddit-Beitrags-URLs werden über Reddits RSS-Feed abgerufen und enthalten den Beitrag sowie die in diesem Feed verfügbaren Kommentare. RSS kann weniger Kommentare enthalten als die Website.

Sicherheit und Grenzen

• Es werden nur öffentliche HTTP(S)-URLs akzeptiert.

• URL-Anmeldeinformationen, private Hostnamen, private DNS-Ergebnisse und unsichere Weiterleitungen werden abgelehnt.

• Jede Weiterleitung wird unabhängig validiert.

• Anfragen verwenden Zeitüberschreitungen, begrenzte Wiederholungsversuche, Antwortgrößenbeschränkungen und einen stabilen Benutzeragenten.

• Standardantworten und Bilder sind auf 5 MiB begrenzt; PDFs sind auf 15 MiB begrenzt.

• Der Abrufcache berücksichtigt Cache-Control: no-store, no-cache und max-age=0.

Dieser Server bietet absichtlich keine Browserautomatisierung, JavaScript-Rendering, Crawling, Authentifizierung, Cookies, Proxy/VPN-Routing oder Antwort-Synthese.

Entwicklung

npm test
npm pack --dry-run

Tests verwenden gespeicherte Testdaten und lokale Stubs anstelle wiederholter Abfragen öffentlicher Dienste.