One Search MCP

🚀 OneSearch MCP 服务器：网络搜索与爬取与抓取与提取

OneSearch MCP 服务器是一个集成了 Searxng、Tavily、DuckDuckGo、Bing 等搜索引擎的模型上下文协议（MCP）服务器实现。它支持网络搜索、本地浏览器搜索、网页抓取和内容提取功能，还与 Firecrawl 集成，为用户提供了强大且全面的网络信息获取解决方案。

✨ 主要特性

• 多工具支持：支持多种网络搜索和网页抓取工具，如 SearXNG、Firecrawl、Tavily、DuckDuckGo、Bing 等。
• 本地浏览器搜索：支持多种搜索引擎，包括 Bing、Google、Baidu、Sogou 等。使用 puppeteer-core 抓取网页内容，需要安装本地浏览器，如 Chromium、Google Chrome、Google Chrome Canary 等，且免费使用，无需密钥。
• 已启用工具：one_search、one_scrape、one_map。
• 自托管服务支持：支持自托管 SearXNG、Firecrawl 等服务（请参阅 部署）。

📦 安装指南

使用 Smithery 自动安装

通过 Smithery 自动为 Claude Desktop 安装 OneSearch：

npx -y @smithery/cli install @yokingma/one-search --client claude

手动安装

# 手动安装（可选）
npm install -g one-search-mcp

# 使用 npx
env SEARCH_API_URL=http://127.0.0.1:8080 FIRECRAWL_API_URL=http://127.0.0.1:3002 npx -y one-search-mcp

📚 详细文档

环境变量配置

搜索引擎相关：

• SEARCH_PROVIDER（可选）：使用的搜索提供程序，支持 searxng、duckduckgo、bing、tavily、local，默认为 local。
• SEARCH_API_URL（可选）：SearxNG API 的 URL，使用 searxng 时必填。
• SEARCH_API_KEY（可选）：搜索 API 的密钥，具体取决于使用的搜索引擎。

示例配置：

# 使用 Searxng 并指定代理和日志级别
SEARXNG_API_URL=https://api.searxng.org \
SEARXNG_API_KEY=your_api_key_here \
SEARCH_PROVIDER=searxng \
LOG_LEVEL=debug

在不同平台的运行配置

在 Cursor 上运行

{
  "mcp": {
    "servers": [
      {
        "type": "file",
        "path": "./config.json"
      }
    ],
    "tools": {
      "one_search": {
        "env": {
          "SEARCH_API_URL": "http://127.0.0.1:8080",
          "FIRECRAWL_API_URL": "http://127.0.0.1:3002"
        }
      }
    }
  }
}

在 Windsurf 上运行

{
  "mcp_server": {
    "tools": {
      "one_search": {},
      "one_scrape": {},
      "one_map": {}
    }
  }
}

自托管服务

• Searxng：支持通过 API 调用进行网络搜索。
• Firecrawl：提供强大的网页抓取和爬虫功能。

故障排除与问题解决

网络连接问题

若无法访问 Searxng 或 Firecrawl 服务，请检查网络配置和代理设置：

# 验证 API 连通性
curl https://api.searxng.org

日志与调试信息

启用详细日志输出以帮助排查问题：

# 启用 debug 级别日志
LOG_LEVEL=debug one-search-mcp

📄 许可证

本项目遵循 MIT 许可证，具体请参阅 LICENSE 文件。

通过以上内容，您可以详细了解如何安装、配置和使用 OneSearch MCP 服务器，并根据实际需求进行相应的调整和优化。