Skip to main content
Glama

Serpex MCP

npm version License: MIT

Ein Model Context Protocol (MCP)-Server, der Multi-Engine-Websuche über die Serpex API bereitstellt. Durchsuchen Sie Google, Bing, DuckDuckGo, Brave, Yahoo und Yandex mit automatischem Engine-Routing und strukturierten JSON-Ergebnissen.

Funktionen

✅ Multi-Engine-Unterstützung: Zugriff auf 6 Suchmaschinen (Google, Bing, DuckDuckGo, Brave, Yahoo, Yandex)
✅ Automatisches Routing: Wählt automatisch die beste verfügbare Suchmaschine aus
✅ Zeitfilterung: Ergebnisse nach Tag, Woche, Monat oder Jahr filtern
✅ Strukturierte Ergebnisse: Saubere, konsistente JSON-Antworten
✅ Schnell & zuverlässig: Integrierte Captcha-Verarbeitung und Proxy-Rotation
✅ Einfache Integration: Funktioniert mit Claude Desktop, Jan AI und jedem MCP-kompatiblen Client

Related MCP server: Serper Search and Scrape MCP Server

Installation

Schnellstart (npx - empfohlen)

Keine Installation erforderlich! Verwenden Sie npx, um direkt zu starten:

npx serpex-mcp

Globale Installation

npm install -g serpex-mcp

Lokale Installation

npm install serpex-mcp

Verwendung

Mit Claude Desktop

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

{
  "mcpServers": {
    "serpex": {
      "command": "npx",
      "args": ["-y", "serpex-mcp"],
      "env": {
        "SERPEX_API_KEY": "your-api-key-here"
      }
    }
  }
}

Mit anderen MCP-Clients

Jeder MCP-kompatible Client kann diesen Server verwenden. Konfigurieren Sie ihn mit:

  • Befehl: npx

  • Argumente: -y serpex-mcp

  • Umgebungsvariable: SERPEX_API_KEY=your-key

Eigenständiger Betrieb

export SERPEX_API_KEY="your-api-key-here"
serpex-mcp

Verfügbare Tools

Durchsuchen Sie das Web mit der Serpex-Multi-Engine-API. Optional wird der vollständige Seiteninhalt (Markdown) der Top-Ergebnisse direkt mit der Suche abgerufen – nach bestem Bemühen. Prüfen Sie daher jedes Ergebnis auf content bzw. content_error.

Parameter:

  • q (erforderlich): Suchanfrage (maximal 500 Zeichen)

  • include_content (optional, boolesch): Ruft auch den vollständigen Seiteninhalt (Markdown) für die Top-Ergebnisse ab. Nach bestem Bemühen – etwa 79 % der Ergebnis-URLs liefern Inhalte; blockierte oder von Robots ausgeschlossene Seiten liefern stattdessen content_error. Standard: false.

  • content_results (optional, 5 | 10): Anzahl der Top-Ergebnisse, für die Inhalte abgerufen werden sollen, wenn include_content auf true gesetzt ist. Muss genau 5 oder 10 sein. Standard: 5.

Beispiel:

{
  "q": "artificial intelligence trends 2025",
  "include_content": true,
  "content_results": 5
}

Antwort (JSON, als Tool-Ausgabetext) enthält content_requested / content_delivered-Zähler und, pro Ergebnis, content bei Erfolg oder content_error bei Fehler – beide Schlüssel werden weggelassen, wenn keine Inhalte angefordert wurden.

So erhalten Sie Ihren API-Schlüssel

  1. Besuchen Sie serpex.dev

  2. Registrieren Sie sich für ein kostenloses Konto.

  3. Holen Sie Ihren API-Schlüssel aus dem Dashboard.

  4. Verwenden Sie ihn in der Umgebungsvariable SERPEX_API_KEY.

API-Informationen

  • Basis-URL: https://api.serpex.dev

  • Dokumentation: https://serpex.dev/docs

  • Preise: Kostenloser Tarif verfügbar, erschwingliche kostenpflichtige Pläne.

Entwicklung

Aus dem Quellcode erstellen

git clone https://github.com/divyeshradadiya/serpex-mcp.git
cd serpex-mcp
pnpm install
pnpm build

Tests ausführen

export SERPEX_API_KEY="your-key-here"
pnpm test

Lizenz

MIT

Available Tools

1 tool

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool update
    • First observedserpex_search

TDQS

B3.3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool has a clear and distinct purpose: searching the web using the Serpex API.

Naming Consistency5/5

Since there is only one tool, naming consistency is inherently perfect. The tool name 'serpex_search' follows a clear and logical pattern, combining the server name with the action.

Tool Count2/5

A single tool is too few for a web search server, as it lacks essential operations like filtering results, handling pagination, or accessing specific search engines individually. This minimal set limits functionality and may cause agent failures in complex tasks.

Completeness2/5

The tool surface is severely incomplete for a web search domain. While the search tool exists, there are significant gaps such as no ability to refine searches, manage result formats, or perform advanced queries, which are common in search APIs.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables web search across multiple search engines (DuckDuckGo, Bing, Startpage) with parallel execution and result deduplication. Also provides web page content extraction capabilities.
    2
    -
  • A
    license
    A
    quality
    D
    maintenance
    Enables advanced web search across multiple search engines (Brave, DuckDuckGo, Google, Bing, Yandex) with intelligent backend selection, full content extraction, and advanced filtering by time, language, geography, and content type.
    3
    MIT
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables searching across multiple search engines (Google, Bing, YouTube, DuckDuckGo, etc.) and retrieving parsed search results via SerpApi integration.
    -