OneSearch MCP Server

by yokingma
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Used for installation and distribution of the MCP server package, with support for running the server through npx commands.

  • Enables web search capabilities through SearXNG, allowing queries to be performed across multiple search engines through a single interface.

  • Supports installation and execution through shell commands, with environment variable configuration for different search providers and APIs.

🚀 OneSearch MCP 服务器:网页搜索、爬取、抓取和提取

模型上下文协议 (MCP) 服务器实现与 Searxng/Tavily/DuckDuckGo/Bing 集成,用于网络搜索、本地浏览器搜索以及使用 Firecrawl 的抓取功能。

特征

  • 网络搜索、抓取、爬行并从网站提取内容。
  • 支持多种搜索引擎和网络爬虫: SearXNGFirecrawlTavilyDuckDuckGoBing等。
  • 本地网页搜索(浏览器搜索),支持多种搜索引擎: BingGoogle百度搜狗等。
    • 使用puppeteer-core从网站上抓取内容。
    • 您应该安装本地浏览器,例如ChromiumGoogle ChromeGoogle Chrome Canary等。
    • 免费,无需钥匙。
  • 启用的工具: one_searchone_scrapeone_map
  • 支持自托管:SearXNG、Firecrawl 等(参见部署

安装

通过 Smithery 安装

要通过Smithery自动安装 OneSearch for Claude Desktop:

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

手动安装

# Manually install (Optional) npm install -g one-search-mcp
# using 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 (可选): 要使用的搜索提供程序,支持searxngduckduckgobingtavilylocal ,默认为local
  • SEARCH_API_URL (可选):SearxNG API 的 URL, searxng需要。
  • SEARCH_API_KEY (可选):搜索提供商的 API 密钥, tavilybing需要。
// supported search providers export type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'local';

火爬:

  • FIRECRAWL_API_URL (可选):Firecrawl API 的 URL, firecrawl所必需的。
  • FIRECRAWL_API_KEY(可选):Firecrawl API 的 API 密钥,如果使用云服务则需要firecrawl

在光标上运行

您的mcp.json文件将如下所示:

{ "mcpServers": { "one-search-mcp": { "command": "npx", "args": ["-y", "one-search-mcp"], "env": { "SEARCH_PROVIDER": "searxng", "SEARCH_API_URL": "http://127.0.0.1:8080", "SEARCH_API_KEY": "YOUR_API_KEY", "FIRECRAWL_API_URL": "http://127.0.0.1:3002", "FIRECRAWL_API_KEY": "YOUR_API_KEY" } } } }

在风帆冲浪中奔跑

将其添加到您的./codeium/windsurf/model_config.json文件中:

{ "mcpServers": { "one-search-mcp": { "command": "npx", "args": ["-y", "one-search-mcp"], "env": { "SEARCH_PROVIDER": "searxng", "SEARCH_API_URL": "http://127.0.0.1:8080", "SEARCH_API_KEY": "YOUR_API_KEY", "FIRECRAWL_API_URL": "http://127.0.0.1:3002", "FIRECRAWL_API_KEY": "YOUR_API_KEY" } } } }

自托管

SearXNG 和 Firecrawl 的本地部署,请参考部署

故障排除

  • [ReferenceError]: __name 未定义:这是因为 Puppeteer 与tsx存在问题, esbuild#1031

执照

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

-
security - not tested
A
license - permissive license
-
quality - not tested

模型上下文协议服务器,可通过 SearXNG、Firecrawl 和 Tavily 等多个引擎实现网页搜索、抓取、爬取和内容提取。

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Environment Variables
      1. Running on Cursor
        1. Running on Windsurf
          1. Self-host
            1. Troubleshooting
              1. License
                ID: rk8s2qldo1