Privacy-focused web search for Zed AI assistant via SearXNG instances. Search the web and read URLs without compromising your privacy.
Overview
This Zed extension provides Model Context Protocol (MCP) server integration with , enabling your AI assistant to search the web and fetch webpage content while respecting your privacy.
Privacy-focused web search via SearXNG instances for Zed AI assistant
🔍 Web Search: Search across multiple search engines via your SearXNG instance
📄 URL Reading: Fetch and convert web pages to markdown for AI analysis
🔒 Privacy-First: All searches go through YOUR configured SearXNG instance
⚡ Fast & Lightweight: 133KB WASM binary, minimal overhead
🛠️ Flexible Configuration: Support for authentication, proxies, and custom headers
⚠️ Security & Privacy
Important Security Considerations:
Credential Storage
Plaintext Storage: Authentication credentials (auth_username, auth_password) are stored unencrypted in your Zed settings.json file
Process Visibility: Credentials are passed as environment variables and may be visible in process lists (via ps, Task Manager, or similar tools)
Recommendation: Use self-hosted SearXNG instances without authentication when possible, or use a reverse proxy with authentication instead of HTTP Basic Auth
Privacy Considerations
Public Instances: Public SearXNG instances (like searx.be) may log your search queries. Check the instance's privacy policy before use
Instance Selection: Visit searx.space to find instances with clear privacy policies and no-logging commitments
SSRF Protection (Configurable)
Default Behavior: Allows localhost and private IP addresses (allow_private_instances: true) to support self-hosted SearXNG instances
Strict Mode: Set allow_private_instances: false to block localhost/RFC1918 private IPs and enforce SSRF protection
When to Use Strict Mode: Only needed in shared/untrusted environments where malicious users might attempt SSRF attacks
Self-Hosted Users: Keep the default true setting to access your local SearXNG instance
Supply Chain Security
This extension uses pinned version 0.8.0 of the mcp-searxng npm package for security
Updates require manual version changes and security review
The extension validates all configuration inputs to prevent injection attacks
Requirements
Zed Editor: Version 0.205.x or higher
Node.js: Version 20 or higher (for npx)
SearXNG Instance: Self-hosted or public instance access
Disclosure
This extension was coded primarily by AI agents as a learning exercise with care and intentionality including semi-automated code review for quality and security. Use at your own risk.
Installation
1. Install the Extension
Option A: From Zed Extensions (Recommended)
Open Zed
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Linux/Windows)
Search for "zed: extensions"
Search for "MCP Server: SearXNG"
Click "Install"
Option B: As Dev Extension (For Development)
Clone this repository
Open Zed
Press Cmd+Shift+P and search for "zed: install dev extension"
Select the extension directory
2. Find a SearXNG Instance
Public Instances:
Visit searx.space to find public SearXNG instances. Choose one with:
The assistant should now have access to searxng_web_search and web_url_read tools
Note: Zed automatically converts settings from settings.json into environment variables that are passed to the MCP server. The extension validates these settings and provides helpful error messages if something is misconfigured.
Note:allow_private_instances defaults to true, so you can omit it for localhost instances.
Authenticated SearXNG Instance
⚠️ Security Warning: Credentials are stored in plaintext in settings.json and visible in process environment. Only use this with trusted, self-hosted instances.
See TESTING.md for comprehensive testing procedures including:
Manual testing guide with 17 test cases
Validation tests for URL formats and configuration
Integration tests for auth and proxy scenarios
Performance and regression testing procedures
Test report templates
Testing Locally
# Install as dev extension in Zed
# zed: install dev extension (Cmd+Shift+P)
# View logs
# zed: open log (Cmd+Shift+P)
# Run validation tests
# See TESTING.md for detailed test cases
Architecture
This extension follows the Zed MCP Extension Wrapper Pattern:
Minimal Rust/WASM wrapper - Implements Zed extension API
Delegates to npm package - Uses proven mcp-searxng implementation
Configuration bridge - Maps Zed settings to environment variables
This approach:
✅ Leverages battle-tested MCP server code
✅ Minimizes maintenance burden
✅ Keeps WASM binary small (147KB)
✅ Follows official Zed patterns
Contributing
Contributions welcome! Please:
Read the code of conduct
Fork the repository
Create a feature branch
Make your changes with tests
Run cargo clippy and cargo fmt
Submit a pull request
Contributing New Search Functionality
This extension is designed to be modular and extensible. If you'd like to add support for additional search engines, here's how to maintain consistency with the existing architecture:
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo MCP Server Searxng?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿MCP Server Searxng necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa MCP Server Searxng?
MCP Server Searxng se ejecuta localmente por stdio.
¿Cuándo se comprobó MCP Server Searxng por última vez?
Última comprobación: 2026-10-28. Privacy-focused web search via SearXNG instances for Zed AI assistant