Skip to main content
Glama

Serpex MCP

npm version License: MIT

一个通过 Serpex API 提供多引擎 Web 搜索功能的 Model Context Protocol (MCP) 服务器。支持在 Google、Bing、DuckDuckGo、Brave、Yahoo 和 Yandex 之间搜索,并具备自动引擎路由和结构化 JSON 结果。

功能

✅ 多引擎支持:可访问 6 个搜索引擎(Google、Bing、DuckDuckGo、Brave、Yahoo、Yandex)
✅ 自动路由:自动选择最佳可用搜索引擎
✅ 时间过滤:按天、周、月或年过滤结果
✅ 结构化结果:干净、一致的 JSON 响应
✅ 快速且可靠:内置验证码处理和代理轮换
✅ 易于集成:适用于 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 多引擎 API 搜索网络。可选择在搜索结果中内联获取排名靠前结果的完整页面内容(markdown)——尽力而为,因此请检查每个结果是包含 content 还是 content_error。

参数:

  • q(必填):搜索查询字符串(最多 500 个字符)

  • include_content(可选,布尔值):同时获取排名靠前结果的完整页面内容(markdown)。尽力而为——约 79% 的结果 URL 会返回内容;被屏蔽或不允许爬虫抓取的页面则返回 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

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