One Search MCP

🚀 OneSearch MCP Server: Web Search, Crawling, and Extraction

OneSearch MCP Server is a Model Context Protocol (MCP) server implementation that integrates search engines such as Searxng, Tavily, DuckDuckGo, and Bing. It supports web search, local browser search, web page crawling, and content extraction, and is integrated with Firecrawl.

✨ Features

• Multiple Search and Crawling Tools: Supports various web search and web crawling tools, including SearXNG, Firecrawl, Tavily, DuckDuckGo, Bing, etc.
• Local Browser Search: Supports multiple search engines like Bing, Google, Baidu, Sogou, etc.
  • Uses puppeteer-core to crawl web page content.
  • Requires a local browser installation, such as Chromium, Google Chrome, Google Chrome Canary, etc.
  • Free to use without API keys.
• Enabled Tools: one_search, one_scrape, one_map
• Self - hosted Services: Supports self - hosting services like SearXNG and Firecrawl (see Deployment).

📦 Installation

Automatic Installation via Smithery

Automatically install OneSearch for Claude Desktop through Smithery:

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

Manual Installation

# Manual installation (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 Variable Configuration

Search Engine - Related:

• SEARCH_PROVIDER (optional): The search provider to use, supporting searxng, duckduckgo, bing, tavily, local, with the default being local.
• SEARCH_API_URL (optional): The URL of the SearxNG API, required when using searxng.
• SEARCH_API_KEY (optional): The API key for the search API, depending on the search engine used.

Example Configuration:

# Use Searxng and specify proxy and log level
SEARXNG_API_URL=https://api.searxng.org \
SEARXNG_API_KEY=your_api_key_here \
SEARCH_PROVIDER=searxng \
LOG_LEVEL=debug

💻 Usage Examples

Running on 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"
        }
      }
    }
  }
}

Running on Windsurf

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

📚 Self - hosted Services

• Searxng: Supports web search through API calls.
• Firecrawl: Provides powerful web crawling and spidering capabilities.

🛠️ Troubleshooting

Network Connectivity Issues

If you cannot access the Searxng or Firecrawl services, check your network configuration and proxy settings:

# Verify API connectivity
curl https://api.searxng.org

Logs and Debug Information

Enable detailed log output to help troubleshoot issues:

# Enable debug - level logs
LOG_LEVEL=debug one-search-mcp

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

With the above information, you can learn in detail how to install, configure, and use the OneSearch MCP Server, and make corresponding adjustments and optimizations according to your actual needs.