OneSearch MCP Server

by yokingma
Verified

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 Server: Web Search & Crawl & Scraper & Extract

A Model Context Protocol (MCP) server implementation that integrates with Searxng/Firecrawl/Tavily for web search and scraping capabilities.

Features

  • Web Search, scrape, crawl and extract content from websites.
  • Support multiple search engines and web scrapers: SearXNG, Firecrawl, Tavily, etc.
  • Support for self-hosted: SearXNG, Firecrawl, etc. (see Deploy)
  • Enabled tools: one_search, one_scrape

Installation

# 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

Environment Variables

Search:

  • SEARCH_PROVIDER (Optional): The search provider to use, either searxng or tavily, default is searxng.
  • SEARCH_API_URL (Optional): The URL of the SearxNG API, required for searxng.
  • SEARCH_API_KEY (Optional): The API key for the search provider, required for tavily.

Firecrawl:

  • FIRECRAWL_API_URL (Optional): The URL of the Firecrawl API, required for firecrawl.
  • FIRECRAWL_API_KEY (Optional): The API key for the Firecrawl API, required for firecrawl if using cloud service.

Running on Cursor

Your mcp.json file will look like this:

{ "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" } } } }

Running on Windsurf

Add this to your ./codeium/windsurf/model_config.json file:

{ "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" } } } }

Self-host

Local deployment of SearXNG and Firecrawl, please refer to Deploy

License

MIT License - see LICENSE file for details.

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

A Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.

  1. Features
    1. Installation
      1. Environment Variables
        1. Running on Cursor
          1. Running on Windsurf
            1. Self-host
              1. License