Integrations
MCP Server
Give your AI assistants the power to help you more effectively. This server lets them safely access websites and search the web - with clear feedback about what's happening and helpful error messages when things go wrong.
- 🛠️ What tools does this server offer?
- 🏎️ How can I run it?
- 🔌 How to connect
- 📚 Learn more about MCP
- 📄 License
🛠️ What tools does this server offer?
The server provides two powerful tools that help AI assistants solve real-world problems:
Tool | What it can do |
---|---|
Search | Search the web via SearXNG for current information, specific resources, or to perform calculations. |
Web | Access websites and process their content. Can convert pages to markdown for easy reading, get the raw content, or extract links. |
🏎️ How can I run it?
🐋 Using Docker (recommended)
The server runs in Docker containers to keep things safe and simple. Here's how to get started:
- Install Docker if you haven't already
- Create a file called
docker-compose.yml
with:CopyImportant: You must provide the
SEARXNG_QUERY_URL
environment variable, pointing to the Search API endpoint of your SearXNG instance (usually ending in/
or/search
).Setting
SSE_HOST
andSSE_PORT
enables network mode (Server-Sent Events), recommended for multi-container setups like LibreChat. If omitted, the server uses standard I/O. - Run
docker compose up -d
to start the server container (and optionally SearXNG).
Most people use this with either:
- Claude Desktop - connects directly via stdio
(omit
SSE_HOST
/SSE_PORT
indocker-compose.yml
). - LibreChat - connects over the network via SSE.
For LibreChat, add this to your librechat.yaml
(assuming SSE_PORT=8080
):
💻 Running locally
- Install
uv
(requires Python 3.13+):CopyNote: If you already have
uv
installed, update it withuv self update
. - Create and activate a virtual environment:Copy
- Install dependencies from the lockfile:Copy
- Set required environment variables:Copy
- Run the server:Copy
Available arguments:
--sse-host
: SSE listening address (e.g.,0.0.0.0
). Enables SSE mode.--sse-port
: SSE listening port (e.g.,3001
). Enables SSE mode.--user-agent
: Custom User-Agent string (overridesUSER_AGENT
env var).
Note: If neither
--sse-host
nor--sse-port
are provided (andSSE_HOST
/SSE_PORT
env vars are not set), the server defaults tostdio
mode. TheSEARXNG_QUERY_URL
environment variable is always required.
🔌 How to connect
You can connect to the server in two ways:
Method | What it means | When to use it |
---|---|---|
Network connection (SSE) | The server listens on a network port for connections. | Best for LibreChat or other networked clients. |
Direct connection (stdio) | The server communicates directly via standard input/out. | Useful for local testing or Claude Desktop. |
📚 Learn more about MCP
Here are a few resources to get you started:
📄 License
This project is licensed under the GPLv3. See the LICENSE file for full details.
This server cannot be installed
A server that enables AI assistants like Claude to safely run Python code and access websites, processing data for better AI understanding while providing helpful error messages.