Skip to main content
Glama
deenesjakoruzh
olostep

olostep-mcp

by olostep
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Olostep MCP Server

Docker Hub npm version Lizenz: ISC

Eine Implementierung eines Model Context Protocol (MCP) Servers, die sich für Web-Scraping, Inhaltsextraktion und Suchfunktionen in Olostep integriert. Um den Olostep MCP Server einzurichten, benötigen Sie einen API-Schlüssel. Sie erhalten diesen durch eine Registrierung auf der Olostep-Website.

Funktionen

  • Website-Inhalte in HTML, Markdown, JSON oder Klartext scrapen (mit optionalen Parsern)

  • Parser-basierte Websuche mit strukturierten Ergebnissen

  • KI-Antworten mit Quellenangaben und optionalen JSON-formatierten Ausgaben

  • Batch-Scraping von bis zu 10.000 URLs

  • Autonomes Site-Crawling ausgehend von einer Start-URL

  • Website-URL-Erkennung und -Mapping (mit Include/Exclude-Filtern)

  • Länderspezifisches Request-Routing für geo-targetierte Inhalte

  • Konfigurierbare Wartezeiten für JavaScript-lastige Websites

  • Umfassende Fehlerbehandlung und Berichterstattung

  • Einfache API-Schlüssel-Konfiguration

Related MCP server: mcp-mistral-ocr

Installation

Es gibt mehrere Möglichkeiten, eine Verbindung zum Olostep MCP Server herzustellen. Wählen Sie diejenige, die am besten zu Ihrem Workflow passt.

☁️ Remote-Endpunkt (Empfohlen)

Der einfachste Weg – keine lokale Installation erforderlich. Verbinden Sie sich direkt mit unserem gehosteten MCP-Server:

https://mcp.olostep.com/mcp

Die Authentifizierung erfolgt über ein Bearer-Token im Authorization-Header unter Verwendung Ihres Olostep-API-Schlüssels. Siehe den Abschnitt Client-Einrichtung weiter unten für Konfigurationsbeispiele.

🐳 Docker Hub

Laden Sie das offizielle Docker-Image herunter und führen Sie es aus:

docker pull olostep/mcp-server

docker run -i --rm \
  -e OLOSTEP_API_KEY="your-api-key" \
  olostep/mcp-server

🔧 Lokaler Docker-Build

Wenn Sie das Image lieber selbst aus dem Quellcode erstellen möchten:

git clone https://github.com/olostep/olostep-mcp-server.git
cd olostep-mcp-server
npm install
npm run build
docker build -t olostep/mcp-server:local .

docker run -i --rm -e OLOSTEP_API_KEY="your-api-key" olostep/mcp-server:local

📦 npx

Führen Sie es ohne Installation mit npx aus:

env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

Unter Windows (PowerShell):

$env:OLOSTEP_API_KEY = "your-api-key"; npx -y olostep-mcp

Unter Windows (CMD):

set OLOSTEP_API_KEY=your-api-key && npx -y olostep-mcp

Oder installieren Sie es global:

npm install -g olostep-mcp

Client-Einrichtung

Cursor

Der einfachste Weg ist die Nutzung des Remote-Endpunkts. Erstellen oder bearbeiten Sie die Datei .cursor/mcp.json in Ihrem Projektstammverzeichnis:

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Alternative (lokal): Gehen Sie zu Cursor-Einstellungen > Features > MCP Servers, klicken Sie auf "+ Add New MCP Server":

  • Name: olostep

  • Typ: command

  • Befehl: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "mcp-server-olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Alternative (Docker):

{
  "mcpServers": {
    "olostep": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "OLOSTEP_API_KEY=YOUR_API_KEY_HERE",
        "olostep/mcp-server"
      ]
    }
  }
}

Oder installieren Sie es über die Smithery CLI in Ihrem Geräteterminal:

npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude

Claude Code

Fügen Sie den Remote-Endpunkt zu Ihrer Claude Code MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Alternative (lokal):

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Windsurf

Fügen Sie dies zu Ihrer ./codeium/windsurf/model_config.json hinzu:

{
  "mcpServers": {
    "olostep": {
      "serverUrl": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Alternative (lokal):

{
  "mcpServers": {
    "mcp-server-olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

VS Code

Fügen Sie dies zu Ihrer .vscode/mcp.json hinzu:

{
  "servers": {
    "olostep": {
      "type": "http",
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Alternative (lokal):

{
  "servers": {
    "olostep": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Metorial

Option 1: Ein-Klick-Installation (Empfohlen)

  1. Öffnen Sie das Metorial Dashboard

  2. Navigieren Sie zum Verzeichnis der MCP-Server

  3. Suchen Sie nach "Olostep"

  4. Klicken Sie auf "Install" und geben Sie Ihren API-Schlüssel ein

Option 2: Manuelle Konfiguration

Fügen Sie dies zu Ihrer Metorial MCP-Serverkonfiguration hinzu:

{
  "olostep": {
    "command": "npx",
    "args": ["-y", "olostep-mcp"],
    "env": {
      "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
    }
  }
}

Die Olostep-Tools stehen dann in Ihren Metorial-KI-Chats zur Verfügung.

Konfiguration

Umgebungsvariablen

  • OLOSTEP_API_KEY: Ihr Olostep-API-Schlüssel (erforderlich)

  • ORBIT_KEY: Ein optionaler Schlüssel für die Nutzung von Orbit zum Routen von Anfragen.

Verfügbare Tools

1. Website scrapen (scrape_website)

Extrahieren Sie Inhalte von einer einzelnen URL. Unterstützt mehrere Formate und JavaScript-Rendering.

{
  "name": "scrape_website",
  "arguments": {
    "url_to_scrape": "https://example.com",
    "output_format": "markdown",
    "country": "US",
    "wait_before_scraping": 1000,
    "parser": "@olostep/amazon-product"
  }
}

Parameter:

  • url_to_scrape: Die URL der Website, die Sie scrapen möchten (erforderlich)

  • output_format: Wählen Sie das Format (html, markdown, json oder text) - Standard: markdown

  • country: Optionaler Ländercode (z. B. US, GB, CA) für standortspezifisches Scraping

  • wait_before_scraping: Wartezeit in Millisekunden vor dem Scraping (0-10000)

  • parser: Optionaler Parser-ID für spezialisierte Extraktion

Antwort (Beispiel):

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"id\": \"scrp_...\",\n  \"url\": \"https://example.com\",\n  \"markdown_content\": \"# ...\",\n  \"html_content\": null,\n  \"json_content\": null,\n  \"text_content\": null,\n  \"status\": \"succeeded\",\n  \"timestamp\": \"2025-11-14T12:34:56Z\",\n  \"screenshot_hosted_url\": null,\n  \"page_metadata\": { }\n}"
    }
  ]
}

2. Websuche (search_web)

Durchsuchen Sie das Web nach einer bestimmten Anfrage und erhalten Sie strukturierte Ergebnisse (keine KI, Parser-basiert).

{
  "name": "search_web",
  "arguments": {
    "query": "your search query",
    "country": "US"
  }
}

Parameter:

  • query: Suchanfrage (erforderlich)

  • country: Optionaler Ländercode für lokalisierte Ergebnisse (Standard: US)

Antwort:

  • Strukturiertes JSON (als Text), das Parser-basierte Ergebnisse darstellt

3. Antworten (KI) (answers)

Durchsuchen Sie das Web und erhalten Sie KI-gestützte Antworten in der gewünschten JSON-Struktur, inklusive Quellen und Zitaten.

{
  "name": "answers",
  "arguments": {
    "task": "Who are the top 5 competitors to Acme Inc. in the EU?",
    "json": "Return a list of the top 5 competitors with name and homepage URL"
  }
}

Parameter:

  • task: Frage oder Aufgabe, die mithilfe von Webdaten beantwortet werden soll (erforderlich)

  • json: Optionales JSON-Schema/Objekt oder eine kurze Beschreibung der gewünschten Ausgabeform

Antwort beinhaltet:

  • answer_id, object, task, result (JSON, falls bereitgestellt), sources, created

4. Batch-Scraping von URLs (batch_scrape_urls)

Scrapen Sie bis zu 10.000 URLs gleichzeitig. Perfekt für die Datenextraktion im großen Stil.

{
  "name": "batch_scrape_urls",
  "arguments": {
    "urls_to_scrape": [
      {"url": "https://example.com/a", "custom_id": "a"},
      {"url": "https://example.com/b", "custom_id": "b"}
    ],
    "output_format": "markdown",
    "country": "US",
    "wait_before_scraping": 500,
    "parser": "@olostep/amazon-product"
  }
}

Antwort beinhaltet:

  • batch_id, status, total_urls, created_at, formats, country, parser, urls

5. Crawl erstellen (create_crawl)

Entdecken und scrapen Sie autonom ganze Websites, indem Sie Links folgen.

{
  "name": "create_crawl",
  "arguments": {
    "start_url": "https://example.com/docs",
    "max_pages": 25,
    "follow_links": true,
    "output_format": "markdown",
    "country": "US",
    "parser": "@olostep/doc-parser"
  }
}

Antwort beinhaltet:

  • crawl_id, object, status, start_url, max_pages, follow_links, created, formats, country, parser

6. Map erstellen (create_map)

Erhalten Sie alle URLs einer Website. Extrahieren Sie alle URLs zur Erkennung und Analyse.

{
  "name": "create_map",
  "arguments": {
    "website_url": "https://example.com",
    "search_query": "blog",
    "top_n": 200,
    "include_url_patterns": ["/blog/**"],
    "exclude_url_patterns": ["/admin/**"]
  }
}

Antwort beinhaltet:

  • map_id, object, url, total_urls, urls, search_query, top_n

7. Webseiteninhalt abrufen (get_webpage_content)

Ruft Webseiteninhalte in sauberem Markdown-Format ab, mit Unterstützung für JavaScript-Rendering.

{
  "name": "get_webpage_content",
  "arguments": {
    "url_to_scrape": "https://example.com",
    "wait_before_scraping": 1000,
    "country": "US"
  }
}

Parameter:

  • url_to_scrape: Die URL der Webseite, die gescrapt werden soll (erforderlich)

  • wait_before_scraping: Zeit in Millisekunden, die vor dem Start des Scrapings gewartet werden soll (Standard: 0)

  • country: Wohnsitzland, von dem aus die Anfrage geladen werden soll (z. B. US, CA, GB) (optional)

Antwort:

{
  "content": [
    {
      "type": "text",
      "text": "# Example Website\n\nThis is the markdown content of the webpage..."
    }
  ]
}

8. Website-URLs abrufen (get_website_urls)

Suchen und rufen Sie relevante URLs von einer Website ab, sortiert nach Relevanz für Ihre Anfrage.

{
  "name": "get_website_urls",
  "arguments": {
    "url": "https://example.com",
    "search_query": "your search term"
  }
}

Parameter:

  • url: Die URL der Website, die gemappt werden soll (erforderlich)

  • search_query: Die Suchanfrage, nach der die URLs sortiert werden sollen (erforderlich)

Antwort:

{
  "content": [
    {
      "type": "text",
      "text": "Found 42 URLs matching your query:\n\nhttps://example.com/page1\nhttps://example.com/page2\n..."
    }
  ]
}

9. Batch-Ergebnisse abrufen (get_batch_results)

Rufen Sie die Ergebnisse eines zuvor übermittelten Batch-Scraping-Jobs mithilfe der batch_id ab.

{
  "name": "get_batch_results",
  "arguments": {
    "batch_id": "batch_abc123"
  }
}

Antwort beinhaltet:

  • batch_id, status (processing oder completed), total_urls, completed_urls, items (Array von gescrapten Ergebnissen pro URL mit url, custom_id, markdown_content, html_content, json_content, text_content, status, page_metadata)

Fehlerbehandlung

Der Server bietet eine robuste Fehlerbehandlung:

  • Detaillierte Fehlermeldungen bei API-Problemen

  • Meldung von Netzwerkfehlern

  • Behandlung von Authentifizierungsfehlern

  • Informationen zu Ratenbegrenzungen

Beispiel für eine Fehlermeldung:

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Olostep API Error: 401 Unauthorized. Details: {\"error\":\"Invalid API key\"}"
    }
  ]
}

Distribution

Docker-Images

Der MCP-Server ist als Docker-Image verfügbar:

  • Docker Hub: [olostep/mcp-server](https://hub.docker.com/r/olostep/mcp-server)

  • Offizielles Docker MCP Registry: mcp/olostep (in Kürze verfügbar - verbesserte Sicherheit mit Signaturen & SBOMs)

  • GitHub Container Registry: ghcr.io/olostep/olostep-mcp-server

Docker Desktop MCP Toolkit

Der Olostep MCP Server wird dem offiziellen MCP Toolkit von Docker Desktop hinzugefügt, was bedeutet, dass Benutzer in der Lage sein werden:

  • Ihn in der MCP Toolkit-Benutzeroberfläche von Docker Desktop zu entdecken

  • Ihn mit einem Klick zu installieren

  • Ihn visuell zu konfigurieren

  • Ihn mit jedem MCP-kompatiblen Client (Claude Desktop, Cursor, etc.) zu verwenden

Status: Einreichung bei der Docker MCP Registry läuft

Unterstützte Plattformen

  • linux/amd64

  • linux/arm64

Lokal bauen

# Clone the repository
git clone https://github.com/olostep/olostep-mcp-server.git
cd olostep-mcp-server

# Build the image
npm install
npm run build
docker build -t olostep/mcp-server .

# Run locally
docker run -i --rm -e OLOSTEP_API_KEY="your-key" olostep/mcp-server

Lizenz

ISC-Lizenz

Install Server
A
security – no known vulnerabilities
A
license - permissive license
B
quality - B tier

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/olostep/olostep-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server