SearxNG Search

by jay4242

Not rated
GitHub

About

Enables web searches through a user-specified SearxNG instance, returning structured results with titles, URLs, and content snippets for private or customized search capabilities.

Details

Author
jay4242
Repository
Jay4242/mcp_searxng_search
License
GNU General Public License v3.0
Categories
Productivity, Developer Tools, Design, AI, Search, Frontend, Infrastructure
Tags
#web, #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name SearxNG Search
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Getting Started

1. Set the SEARXNG_BASE_URL environment variable to the base URL of your SearxNG instance.
2. Install the package: pip install .

Usage with Goose

1. Install the extension: After installing the package, you can add this MCP server as an extension in Goose.
2. Add the extension in Goose: Go to Settings > Extensions > Add.
3. Set the extension type: Set the Type to StandardIO.
4. Provide the extension details: Provide an ID, name, and description for your extension.
5. Set the command: In the Command field, provide the absolute path to your executable using uv run. For example:

    uv run /full/path/to/mcp-searxng-search/.venv/bin/mcp-searxng-search
    

Make sure to replace /full/path/to/mcp-searxng-search with the actual path to your project directory.

6. Using the extension: Once integrated, you can start using your extension in Goose. Open the Goose chat interface and call your tool as needed. You can verify that Goose has picked up the tools from your custom extension by asking it "what tools do you have?"

The tool ID is searxng_search. It accepts two parameters: query (the search query) and max_results (the maximum number of results to return, defaults to 30).

searxng_search

Perform a web search using the SearxNG instance. Parameters: query (string), max_results (optional integer, defaults to 30)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "searxng search": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

MCP SearxNG Search

This project provides an MCP server that allows you to perform web searches using a SearxNG instance. It exposes a tool that can be called by other MCP-compatible applications, such as Goose.

Getting Started

1. Set the SEARXNG_BASE_URL environment variable to the base URL of your SearxNG instance.
2. Install the package: pip install .

Usage with Goose

1. Install the extension: After installing the package, you can add this MCP server as an extension in Goose.
2. Add the extension in Goose: Go to Settings > Extensions > Add.
3. Set the extension type: Set the Type to StandardIO.
4. Provide the extension details: Provide an ID, name, and description for your extension.
5. Set the command: In the Command field, provide the absolute path to your executable using uv run. For example:

    uv run /full/path/to/mcp-searxng-search/.venv/bin/mcp-searxng-search
    

Make sure to replace /full/path/to/mcp-searxng-search with the actual path to your project directory.

6. Using the extension: Once integrated, you can start using your extension in Goose. Open the Goose chat interface and call your tool as needed. You can verify that Goose has picked up the tools from your custom extension by asking it "what tools do you have?"

The tool ID is searxng_search. It accepts two parameters: query (the search query) and max_results (the maximum number of results to return, defaults to 30).

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.