Serpex MCP

一个通过 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_search

使用 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

链接

• Serpex 网站

• Serpex 文档

• Model Context Protocol

• MCP Specification