Skip to main content
Glama
deenesjakoruzh
yokingma

OneSearch MCP Server

by yokingma
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

🚀 OneSearch MCP 服务器：网页搜索、爬取、抓取与内容预处理

一个模型上下文协议 (MCP) 服务器实现，集成了多个搜索提供商，用于网页搜索、本地浏览器搜索，并利用 agent-browser 提供抓取功能。

功能特性

  • 网页搜索、抓取、爬取并预处理来自网站的内容。

  • 支持多种搜索引擎和网页抓取工具：SearXNG、Tavily、DuckDuckGo、Bing、Google、Zhipu (智谱)、Exa、Bocha (博查) 等。

  • 本地网页搜索（浏览器搜索），支持多种搜索引擎：Bing、Google、Baidu、Sogou 等。

    • 使用 agent-browser 进行浏览器自动化。

    • 免费，无需 API 密钥。

  • 已启用工具： one_search、one_scrape、one_map、one_extract

Related MCP server: Firecrawl MCP Server

从 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 的浏览器。

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

  • ✅ Google Chrome

  • ✅ Microsoft Edge

  • ✅ Chromium

  • ✅ Google 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 CLI（推荐）

# 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"
      ]
    }
  }
}

环境变量

搜索引擎：

  • SEARCH_PROVIDER（可选）：要使用的搜索提供商，支持 searxng、duckduckgo、bing、tavily、google、zhipu、exa、bocha、local，默认为 local。

  • SEARCH_API_URL（可选）：SearxNG API 的 URL，或 google 的 Google 自定义搜索引擎 ID。

  • SEARCH_API_KEY（可选）：搜索提供商的 API 密钥，tavily、bing、google、zhipu、exa、bocha 需要此项。

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

搜索提供商配置

提供商

是否需要 API 密钥

是否需要 API URL

备注

local

否

否

免费，使用浏览器自动化

duckduckgo

否

否

免费，无需 API 密钥

searxng

可选

是

自托管元搜索引擎

bing

是

否

Bing 搜索 API

tavily

是

否

Tavily API

google

是

是（搜索引擎 ID）

Google 自定义搜索

zhipu

是

否

智谱 AI

exa

是

否

Exa AI

bocha

是

否

博查 AI

其他 MCP 客户端的配置

Claude Desktop

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

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

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

Cursor

添加到您的 mcp.json 文件中：

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

Windsurf

添加到您的 ./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 可用内存

快速开始：

# 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

有关更多详细信息，请参阅 官方 SearXNG Docker 文档。

故障排除

找不到浏览器错误

如果您看到类似“Browser not found”的错误，说明服务器无法检测到任何已安装的基于 Chromium 的浏览器。请安装以下其中之一：

或者通过 agent-browser 安装：

npx agent-browser install

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
13dResponse time
5wRelease cycle
6Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Firecrawl MCP Server

    ampcome-mcps
    A
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol server that enables web scraping, crawling, and content extraction capabilities through integration with Firecrawl.
    8
    91,121
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • mcp

    A Model Context Protocol server for Wix AI tools

  • qsearch

    Multi-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yokingma/one-search-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server