yokingma_one_search_mcp

yokingma_one_search_mcp

by yokingma
An MCP server implementation for web search, scraping, and content extraction using Searxng, Firecrawl, and Tavily.

OneSearch MCP Server: Web Search & Scraper & Extract

Overview

The OneSearch MCP Server is a Model Context Protocol (MCP) server implementation designed to integrate with search engines and web scrapers like Searxng, Firecrawl, and Tavily. It provides robust web search, crawling, scraping, and content extraction capabilities, making it a powerful tool for developers and researchers.

Features

  • Web Search & Scraping: Perform web searches, crawl websites, and extract content efficiently.
  • Multiple Search Engines: Supports Searxng, Firecrawl, Tavily, and other search providers.
  • Self-Hosted Options: Deploy your own Searxng or Firecrawl instances for full control.
  • Enabled Tools: Includes one_search and one_scrape for seamless integration.

Installation

You can install the OneSearch MCP Server globally or run it directly using npx.

# 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

Configuration

Environment Variables

Search:

  • SEARCH_PROVIDER: Choose between searxng or tavily (default: searxng).
  • SEARCH_API_URL: Required for searxng.
  • SEARCH_API_KEY: Required for tavily.

Firecrawl:

  • FIRECRAWL_API_URL: Required for firecrawl.
  • FIRECRAWL_API_KEY: Required for Firecrawl cloud service.

Usage

Running on Cursor

Add the following configuration to your mcp.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"
      }
    }
  }
}

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-Hosting

For local deployment of Searxng and Firecrawl, refer to the Deploy guide.

License

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

About

The OneSearch MCP Server is a versatile tool for integrating web search and scraping capabilities into your projects. It is actively maintained and supported by the community.

Topics

Resources

Stars

8 stars

Watchers

2 watching

Forks

2 forks

Languages

  • TypeScript: 53.5%
  • JavaScript: 46.5%

Features & Capabilities

Categories
mcp_server model_context_protocol typescript javascript search api_integration searxng firecrawl tavily docker

Implementation Details

Stats

0 Views
8 GitHub Stars

Repository Info

yokingma Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
21423
9300