MCP Server for SearXNG n8n Integration

A Model Context Protocol (MCP) server specifically designed for using SearXNG with n8n workflows.

Usage in n8n

1. Prerequisites:

   • A running n8n instance.

   • Access to a SearXNG instance (e.g., https://your-searxng-instance.com).

   • The n8n-nodes-mcp package installed in your n8n instance.

2. Configure MCP Node (Server Connection):

   • Add an "MCP" node to your workflow.

   • In the node settings, under the Server Connection section:

     • Command: npx

     • Arguments (for npx): -y mcp-server-searxng-n8n --instance=https://your-searxng-instance.com

       • Replace https://your-searxng-instance.com with your actual SearXNG URL.

     • Environment Variables: (Leave empty)

3. Configure MCP Node (Tool Operation):

   • Still in the MCP node settings, under the Operation section:

     • Tool Name: Select search from the dropdown.

     • Arguments (for the 'search' tool): Enter a JSON object containing the parameters for your search. See examples below. You can use n8n expressions like {{ $json.chatInput }} as values within the JSON.

Available Search Parameters (for Tool Arguments JSON)

The search tool supports the following parameters within the JSON object (only q is required):

• q (required): The search query string

• categories: Comma-separated list of search categories

• engines: Comma-separated list of search engines to use

• language: Language code for the search

• time_range: Time range for results (day, month, year)

• safesearch: Safe search level (0: None, 1: Moderate, 2: Strict)

• image_proxy: Proxy image results through SearXNG

• enabled_plugins: Comma-separated list of enabled plugins

• disabled_plugins: Comma-separated list of disabled plugins

• enabled_engines: Comma-separated list of enabled engines

• disabled_engines: Comma-separated list of disabled engines

• format: Output format (json, csv, rss, html). Defaults to json.

Example n8n Tool Arguments (JSON)

JSON Output (Default):

{
  "q": "n8n automation",
  "engines": "google,duckduckgo",
  "language": "en"
}

HTML Output:

{
  "q": "n8n automation",
  "format": "html"
}

(Remember to only include the parameters you need in the JSON)

Development

git clone https://github.com/tamler/mcp-server-searxng-n8n.git
cd mcp-server-searxng-n8n
npm install
npm run build

Test with:

# Note the double dash -- to pass arguments to the script via npm start
npm start -- --instance=https://your-searxng-instance.com

License

MIT