One Search MCP

🚀 OneSearch MCP服务器：网络搜索、抓取、抓取和内容准备

一种模型上下文协议（MCP）服务器实现，与多个搜索提供商集成，用于网络搜索、本地浏览器搜索和代理浏览器的抓取功能。

特性

• 网络搜索、抓取、抓取和预处理网站内容。
• 支持多个搜索引擎和网页抓取器： SearXNG, 塔维利, DuckDuckGo, 必应, 谷歌, Zhipu (智谱), 艾克萨, Bocha (博查)等等。
• 本地网络搜索 （浏览器搜索），支持多个搜索引擎： 必应, 谷歌, 百度, 搜狗等等。

- 使用 agent-browser 用于浏览器自动化。 - 免费，不需要API密钥。

• 启用的工具： one_search, one_scrape, one_map, one_extract

从v1.1.0及更早版本迁移

v1.1.0中的重大更改：

• Firecrawl已删除：Firecrawl集成已被删除，取而代之的是 agent-browser，提供了类似的功能，而不需要外部API服务。
• 新浏览器要求：您必须安装Chromium浏览器（请参阅先决条件部分）。
• 环境变量: FIRECRAWL_API_URL 和 FIRECRAWL_API_KEY 不再使用。

发生了什么变化：

• one_scrape 和 one_map 现在使用 agent-browser 而不是Firecrawl
• one_extract 现在预处理多URL页面内容以进行下游分析，而不是执行内置的LLM提取
• 所有基于浏览器的操作现在都在本地处理，提供了更好的隐私，并且不需要API成本

迁移步骤：

1. 安装Chromium浏览器（请参阅先决条件）
2. 移除 FIRECRAWL_API_URL 和 FIRECRAWL_API_KEY 根据您的环境变量
3. 更新到最新版本： npm install -g one-search-mcp@latest

先决条件

浏览器要求：此服务器使用 agent-browser 用于网络抓取和本地搜索，这需要基于Chromium的浏览器。

好消息：服务器将自动检测并使用您系统上已安装的浏览器：

• ✅ 谷歌浏览器
• ✅ 微软边缘
• ✅ 铬
• ✅ 谷歌Chrome Canary

如果你没有安装这些浏览器，您可以：

# Option 1: Install Google Chrome (Recommended)
# Download from: https://www.google.com/chrome/

# Option 2: Install Microsoft Edge
# Download from: https://www.microsoft.com/edge

# Option 3: Install Chromium via agent-browser
npx agent-browser install

# Option 4: Install Chromium directly
# Download from: https://www.chromium.org/getting-involved/download-chromium/

安装

使用Claude Code命令行界面（推荐）

# Add to Claude Code with default settings (local search)
claude mcp add one-search-mcp -- npx -y one-search-mcp

# Add with custom search provider (e.g., SearXNG)
claude mcp add one-search-mcp -e SEARCH_PROVIDER=searxng -e SEARCH_API_URL=http://127.0.0.1:8080 -- npx -y one-search-mcp

# Add with Tavily API
claude mcp add one-search-mcp -e SEARCH_PROVIDER=tavily -e SEARCH_API_KEY=your_api_key -- npx -y one-search-mcp

手动安装

# Install globally (Optional)
npm install -g one-search-mcp

# Or run directly with npx
npx -y one-search-mcp

使用Docker

Docker镜像包括预安装的所有依赖项（Chromium浏览器），不需要额外的设置。

拉取图像：

# From GitHub Container Registry
docker pull ghcr.io/yokingma/one-search-mcp:latest

# Or from Docker Hub
docker pull zacma/one-search-mcp:latest

使用Claude Desktop进行配置：

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/yokingma/one-search-mcp:latest"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

使用自定义搜索提供程序：

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEARCH_PROVIDER=tavily",
        "-e", "SEARCH_API_KEY=your_api_key",
        "ghcr.io/yokingma/one-search-mcp:latest"
      ]
    }
  }
}

环境变量

搜索引擎：

• 搜索_提供者 （可选）：要使用的搜索提供程序，支持 searxng, duckduckgo, bing, tavily, google, zhipu, exa, bocha, local，默认值为 local.
• 搜索_API_URL （可选）：SearxNG API的URL，或的Google自定义搜索引擎ID google.
• 搜索_API_KEY （可选）：搜索提供程序的API密钥，对于 tavily, bing, google, zhipu, exa, bocha.

// supported search providers
export type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'google' | 'zhipu' | 'exa' | 'bocha' | 'local';

搜索提供程序配置

其他MCP客户端的配置

克劳德桌面版

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

光标

添加到您的 mcp.json 文件：

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

帆板运动

添加到您的 ./codeium/windsurf/model_config.json 文件：

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

自托管SearXNG（可选）

如果你想使用SearXNG作为你的搜索提供商，你可以使用Docker在本地部署它：

先决条件：

• Docker已安装并正在运行（20.10.0或更高版本）
• 至少4GB可用RAM

快速入门：

# Clone SearXNG Docker repository
git clone https://github.com/searxng/searxng-docker.git
cd searxng-docker

# Start SearXNG
docker compose up -d

部署后，SearXNG将在 http://127.0.0.1:8080 默认情况下。

配置OneSearch以使用SearXNG：

# Set environment variables
export SEARCH_PROVIDER=searxng
export SEARCH_API_URL=http://127.0.0.1:8080

有关更多详细信息，请参阅 .

故障排除

浏览器未找到错误

如果您看到“未找到浏览器”之类的错误，则服务器无法检测到任何已安装的基于Chromium的浏览器。请安装以下之一：

• 谷歌浏览器:
• 微软边缘:
• 铬:

或通过代理浏览器安装：

npx agent-browser install

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。