Evomi MCP-Server

Ein Model-Context-Protocol- (MCP-)Server für Evomis Proxy- und Webscraping-APIs. Er gibt KI-Assistenten wie Claude direkten Zugriff auf ein Proxy-Konto – Anmeldedaten, Verbindungszeichenfolgen, Geo-Targeting, Nutzung, Sitzungsrotation – sowie eine vollständige Scraping-Toolbox zum Durchsuchen von Websites und Extrahieren strukturierter Daten.

Standardmäßig 39 Tools, mit EVOMI_ENABLE_SPENDING=1 40.

Funktionen

Proxy- und Kontoverwaltung

• Proxy-Anmeldedaten – Benutzername und Passwort für jedes Produkt im Konto

• Verbindungszeichenfolgen – Gezielte, sitzungsgebundene Zeichenfolgen mit einem Curl-Befehl zur Überprüfung

• Proxylisten in großen Mengen – Bis zu 50 Endpunkte pro Aufruf

• Geo-Targeting – Durchsuchen Sie die Länder, Regionen, Städte und ISPs, die ein Produkt tatsächlich anbietet

• Nutzung und Guthaben – Bandbreite über 24 h, 3 Tage und 7 Tage, insgesamt und pro Bucket

• Sitzungssteuerung – Eine sticky Session auf eine neue Ausgangs-IP umleiten

• Browserprofile – Gespeicherte Fingerprinting-Profile auflisten und weitere per Opt-in bestellen

• Servicezugriff – Scraper- und Browser-Credits, Parallelität und Endpunkte

Web Scraping

• Einzelseiten-Scraping – Jede URL mit automatischer JavaScript-Erkennung abrufen

• Website-Crawling – Mehrseitiges Crawling mit Tiefensteuerung

• URL-Erkennung – URLs über Sitemaps, CommonCrawl oder internes Crawling finden

• Domain-Suche – Domains über die Websuche finden

• KI-gestützte Extraktion – KI zum Extrahieren strukturierter Daten aus Seiten nutzen

• Konversationsagent – Natürliche Sprachschnittstelle für Scraping-Aufgaben

• Konfigurationsverwaltung – Scraping-Konfigurationen speichern und wiederverwenden

• Schemaverwaltung – Extraktionsschemata definieren und testen

• Speicherkonfiguration – Cloud-Speicher für gescrapte Daten verwalten

• Geplante Aufträge – Scraping nach Zeitplan automatisieren

Installation

pip install evomi-mcp

Erfordert Python 3.10 oder neuer. Der Server läuft mit beiden Hauptversionen des mcp-SDKs (>=1.8.0,<3), sodass er sowohl in einer Umgebung installiert wird, die bereits auf 1.x festgelegt ist, als auch in einer frischen Umgebung, die 2.x auflöst.

Führen Sie evomi-mcp --help aus, um die Umgebungsvariablen anzuzeigen, die gelesen werden, oder evomi-mcp --version für die installierte Version. Ohne Argumente kommuniziert er über stdio mit MCP, so startet ihn ein MCP-Client.

Konfiguration

Ein Zugangsdatensatz genügt:

export EVOMI_PUBLIC_API_KEY="your-public-api-key"

Holen Sie es unter Einstellungen > API für ein persönliches Konto oder unter Einstellungen > Team für ein Teamkonto. Es authentifiziert die Proxy- und Kontotools direkt, und die Scraping-Tools authentifizieren sich mit dem Scraper-Schlüssel des Kontos, den der Server beim ersten Scraping-Aufruf aus der Public API liest und für den Prozess im Speicher behält. Er wird nie auf die Festplatte geschrieben und erscheint nie in der Tool-Ausgabe.

Wo eine bestimmte Variable gesetzt ist, hat sie Vorrang vor EVOMI_API_KEY. Auch das alleinige Setzen eines Scraper-Schlüssels funktioniert, und die Proxy- und Kontotools benötigen dann ebenfalls EVOMI_PUBLIC_API_KEY, da ein Schlüssel nicht beiden APIs dienen kann.

Optionale Einstellungen:

export EVOMI_BASE_URL="https://scrape.evomi.com"   # scraper API, default
export EVOMI_PUBLIC_BASE_URL="https://api.evomi.com"  # public API, default
export EVOMI_HIDE_PROXY_PASSWORDS=1  # mask every proxy password and service API key
export EVOMI_ENABLE_SPENDING=1  # register the tools that spend account balance

Anmeldedaten in der Tool-Ausgabe

get_proxy_credentials, build_proxy_connection_string und generate_proxy_list geben Live-Proxy-Passwörter zurück, wofür sie gedacht sind, und get_api_access gibt bei Anfrage mit include_api_key einen Service-API-Schlüssel zurück. Jedes andere Tool gibt nur Guthaben, Endpunkte, Nutzungs- und Targeting-Daten zurück.

Drei Dinge begrenzen das. Diese vier Tools enthalten in ihrer Beschreibung den Hinweis, den Wert nicht zu wiederholen, es sei denn, er wurde direkt angefragt – die MCP-Spezifikation hat keine Anmerkung für ein sensibles Ergebnis, daher ist die Beschreibung der einzige Kanal, der das Modell erreicht. generate_proxy_list und build_proxy_connection_string geben höchstens 50 Einträge pro Aufruf zurück, weit unter den 500, die die Public API erlaubt, und verweigern eine größere Anfrage, anstatt sie zu kürzen. Und EVOMI_HIDE_PROXY_PASSWORDS=1 deaktiviert die Offenlegung vollständig:

Die beiden, die verweigern, tun dies, weil ihre gesamte Ausgabe die Anmeldeinformation ist: Eine Verbindungszeichenfolge mit maskiertem Passwort kann keine Verbindung herstellen. Die Verweigerung verweist auf list_proxy_products und list_proxy_targeting_options, die den Gateway-Hostnamen, Ports und Targeting-Werte ohne Anmeldeinformationen liefern, und auch die Beschreibungen, die das Modell sieht, ändern sich.

EVOMI_ENABLE_SPENDING=1 ist das Gegenteil, ein Opt-in für das eine Tool, das Geld kostet. Ohne sie ist order_browser_profile gar nicht erst registriert, sodass das verbundene Modell es nie sieht.

Tool-Anmerkungen

Jedes Tool setzt alle vier Hinweise der MCP-Spezifikation. destructiveHint und openWorldHint sind standardmäßig true, sodass ein Tool, das sie weglässt, sich selbst als potenziell destruktiv und als Erreichen einer unbegrenzten externen Welt darstellt.

openWorldHint ist true für die Tools, die eine vom Aufrufer gewählte Adresse erreichen (scrape_url, crawl_website, map_website, search_domains, agent_request sowie die Schema- und Konfigurationstools, die anhand der Seite validieren, die sie beschreiben), und false für alles, was nur mit Evomis eigenen Endpunkten kommuniziert. readOnlyHint ist false für die Tools, die etwas erstellen, aktualisieren, löschen, umschalten, rotieren oder bestellen. Das Präfix MUTATING bei rotate_proxy_session und order_browser_profile steht ebenfalls in der Beschreibung, da die Beschreibung jedes Modell erreicht, während eine Annotation nur einen Client erreicht, der sie liest.

Verwendung mit Claude Desktop

Fügen Sie Ihrer Claude-Desktop-Konfiguration Folgendes hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "evomi": {
      "command": "evomi-mcp",
      "env": {
        "EVOMI_PUBLIC_API_KEY": "your-public-api-key"
      }
    }
  }
}

Oder wenn aus dem Quellcode installiert:

{
  "mcpServers": {
    "evomi": {
      "command": "python",
      "args": ["-m", "evomi_mcp.server"],
      "env": {
        "EVOMI_PUBLIC_API_KEY": "your-public-api-key"
      }
    }
  }
}

Verfügbare Tools

Proxy & Konto (9 Tools, Evomi Public API, + 1 Opt-in)

Scraping-Vorgänge (6 Tools)

Konfigurationsverwaltung (6 Tools)

Schemaverwaltung (6 Tools)

Speicherverwaltung (4 Tools)

Zeitplanverwaltung (7 Tools)

Konto (1 Tool)

Tool-Beispiele

Scraping

// Basic scrape
{"url": "https://example.com"}

// AI extraction
{"url": "https://example.com/products", "ai_enhance": true, "ai_prompt": "Extract product names and prices"}

// Browser mode with actions
{"url": "https://example.com", "mode": "browser", "js_instructions": [{"click": ".accept-cookies"}, {"wait": 1000}]}

Crawling

// Basic crawl
{"domain": "example.com", "max_urls": 50}

// With URL filter
{"domain": "example.com", "url_pattern": "/products/", "depth": 3}

Domain-Suche

// Find domains
{"query": "best e-commerce sites for electronics", "max_urls": 20, "region": "us-en"}

// Up to 10 queries in one call, max_urls applying to each
{"query": ["online bookstores", "book shops UK"], "max_urls": 50}

Konfigurationsverwaltung

// Create config
{"name": "Product Scraper", "config": {"mode": "browser", "output": "markdown"}}

// Generate config with AI
{"name": "Amazon Scraper", "prompt": "Scrape product title, price, and reviews from Amazon"}

Zeitplanung

// Create daily schedule
{"name": "Daily Prices", "config_id": "cfg_abc123", "interval_minutes": 1440, "start_time": "09:00"}

Credits

Scraping-Vorgänge verbrauchen Credits, und was ein Aufruf kostet, hängt vom Modus und den Optionen ab, mit denen er ausgeführt wird. Die aktuellen Preise finden Sie unter docs.evomi.com; get_api_access meldet den Kontostand.

Jede Scraping-Antwort enthält credits_used und credits_remaining, sodass die Kosten eines Aufrufs im jeweiligen Ergebnis sichtbar sind.

Entwicklung

Einrichtung

pip install -e ".[dev]"

Server direkt ausführen

evomi-mcp
# or
python -m evomi_mcp.server

Tests

pytest

Die Testsuite läuft gegen beide mcp-Hauptversionen, und CI führt sie auf jeder davon über die unterstützten Python-Versionen aus.

Veröffentlichung

Die Version ist sowohl in pyproject.toml als auch in src/evomi_mcp/__init__.py deklariert, und CI schlägt fehl, wenn sie nicht übereinstimmen. Die Veröffentlichung eines GitHub-Releases mit dem Tag vX.Y.Z erstellt die Artefakte, führt die Testsuite gegen das erstellte Wheel aus und lädt es über Trusted Publishing auf PyPI hoch, sodass es nirgendwo ein Token gibt.

Links

• Evomi Website

• Evomi Dashboard

• API-Dokumentation

Lizenz

MIT – siehe LICENSE.