Skip to main content
Glama
Sign In
enesjakozh

OneSearch MCP Server

by yokingma
npmGitHub
TypeScript
MIT License
35
11
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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/Tavily/DuckDuckGo/Bing for web search, local browser search, and scraping capabilities with Firecrawl.

Features

  • Web Search, scrape, crawl and extract content from websites.
  • Support multiple search engines and web scrapers: SearXNG, Firecrawl, Tavily, DuckDuckGo, Bing, etc.
  • Local web search (browser search), support multiple search engines: Bing, Google, Baidu, Sogou, etc.
    • Use puppeteer-core to scrape content from websites.
    • You should have a local browser installed, such as Chromium, Google Chrome, Google Chrome Canary, etc.
    • Free, no keys required.
  • Enabled tools: one_search, one_scrape, one_map
  • Support for self-hosted: SearXNG, Firecrawl, etc. (see Deploy)

Installation

Installing via Smithery

To install OneSearch for Claude Desktop automatically via Smithery:

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

Manual 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 Engine:

  • SEARCH_PROVIDER (Optional): The search provider to use, supports searxng, duckduckgo, bing, tavily, local, default is local.
  • 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, bing.
// supported search providers export type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'local';

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

Troubleshooting

  • [ReferenceError]: __name is not defined: This is because Puppeteer has problems with tsx, esbuild#1031

License

MIT License - see LICENSE file for details.

This server cannot be installed

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

hybrid server

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

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. Installing via Smithery
      2. Manual Installation
    2. Environment Variables
      1. Running on Cursor
        1. Running on Windsurf
          1. Self-host
            1. Troubleshooting
              1. License

                Related Resources

                Related MCP Servers

                • mcp-server-firecrawl

                  mendableai
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol (MCP) server implementation that integrates with FireCrawl for advanced web scraping capabilities.
                  Last updated -
                  9
                  16,506
                  3,053
                  JavaScript
                  MIT License
                  • Apple
                  • Linux

                • MCP Server Fetch TypeScript

                  tatn
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that provides web content fetching and conversion capabilities.
                  Last updated -
                  4
                  89
                  2
                  JavaScript
                  MIT License
                  • Apple

                • MCP Tavily

                  kshern
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server enabling advanced search and content extraction using the Tavily API, with rich customization and integration options.
                  Last updated -
                  4
                  57
                  1
                  JavaScript
                  MIT License

                • WebSearch

                  josemartinrodriguezmortaloni
                  A
                  security
                  F
                  license
                  A
                  quality
                  Built as a Model Context Protocol (MCP) server that provides advanced web search, content extraction, web crawling, and scraping capabilities using the Firecrawl API.
                  Last updated -
                  4
                  1
                  Python
                  • Apple
                  • Linux

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                ID: rk8s2qldo1