MCP Server for SearXNG n8n Integration

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