Skip to main content
Glama
deenesjakoruzh
divyeshradadiya

Serpex MCP

by divyeshradadiya
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Serpex MCP

npm version License: MIT

Model Context Protocol（MCP）サーバーで、Serpex API を通じてマルチエンジンのウェブ検索機能を提供します。Google、Bing、DuckDuckGo、Brave、Yahoo、Yandex を、自動エンジンルーティングと構造化された JSON 結果で検索できます。

機能

✅ マルチエンジン対応: 6つの検索エンジン（Google、Bing、DuckDuckGo、Brave、Yahoo、Yandex）にアクセス
✅ 自動ルーティング: 利用可能な最適な検索エンジンを自動選択
✅ 期間フィルタリング: 日、週、月、年の単位で結果をフィルタリング
✅ 構造化結果: クリーンで一貫性のあるJSONレスポンス
✅ 高速＆信頼性: 組み込みのCAPTCHA処理とプロキシローテーション
✅ 簡単な統合: Claude Desktop、Jan AI、およびMCP互換のクライアントで動作

Related MCP server: Serper Search and Scrape MCP Server

インストール

クイックスタート（npx - 推奨）

インストールは不要です！npx で直接実行できます:

npx serpex-mcp

グローバルインストール

npm install -g serpex-mcp

ローカルインストール

npm install serpex-mcp

使用方法

Claude Desktopを使用する

Claude Desktopの設定（macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します:

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

他のMCPクライアントの場合

MCP互換のクライアントであれば、このサーバーを使用できます。次のように設定します:

  • コマンド: npx

  • 引数: -y serpex-mcp

  • 環境変数: SERPEX_API_KEY=your-key

スタンドアロン

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

利用可能なツール

serpex_search

Serpex マルチエンジン API を使用してウェブを検索します。オプションで、検索とインラインで上位結果のページ全体のコンテンツ（Markdown）を取得します。ベストエフォートのため、各結果の content と content_error を確認してください。

パラメータ:

  • q（必須）: 検索クエリ文字列（最大500文字）

  • include_content（オプション、boolean）: 上位結果のページ全体のコンテンツ（Markdown）も取得します。ベストエフォートです。約79%の結果URLでコンテンツが返されますが、ブロックされたページやrobots.txtで許可されていないページでは代わりに content_error が返されます。デフォルト: false。

  • content_results（オプション、5 | 10）: include_content が true の場合にコンテンツを取得する上位結果の数。5 または 10 のいずれかでなければなりません。デフォルトは 5 です。

例:

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

レスポンス（JSON、ツール出力テキストとして）には、content_requested / content_delivered のカウントと、各結果ごとに成功時は content、失敗時は content_error が含まれます。コンテンツが要求されなかった場合は、両方のキーが省略されます。

APIキーの取得

  1. serpex.dev にアクセスします

  2. 無料アカウントに登録します

  3. ダッシュボードからAPIキーを取得します

  4. それを SERPEX_API_KEY 環境変数で使用します

API情報

  • ベースURL: https://api.serpex.dev

  • ドキュメント: https://serpex.dev/docs

  • 料金: 無料枠あり、手頃な価格の有料プラン

開発

ソースからビルド

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

テストを実行

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

ライセンス

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
Deploy Server
Give agents eyes on the webHosted screenshot MCP. Send a URL, get a pixel-perfect image. $0.002 per grab. Works with Claude, Cursor, and Codex.grabbit.liveAd

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

Resources

Related MCP Connectors

Related MCP Servers

  • Web Search MCP Server

    vishalkg
    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
    -

  • MCP MixSearch

    geosp
    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

  • SerpApi MCP Server

    MCP-Mirror
    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.
    -

Appeared in Searches