MCP 服务器

赋予您的 AI 助手更强大的功能，使其能够更有效地为您提供帮助。该服务器可让它们安全地访问网站并进行搜索，并提供清晰的实时反馈，并在出现问题时提供有用的错误消息。

🛠️ 该服务器提供哪些工具？

该服务器提供了两个强大的工具，帮助AI助手解决现实世界的问题：

工具	它能做什么
搜索	通过 SearXNG 在网络上搜索当前信息、特定资源或执行计算。
网络	访问网站并处理其内容。可以将页面转换为 Markdown 格式以便于阅读，获取原始内容或提取链接。

Related MCP server: MCP Python Toolbox

🏎️我该如何运行它？

🐋 使用 Docker（推荐）

该服务器在 Docker 容器中运行，以确保安全且简单。以下是入门方法：

如果尚未安装 Docker
创建一个名为docker-compose.yml的文件，内容如下：
services: mcp-server: environment: # Required: URL for your SearXNG instance's Search API - SEARXNG_QUERY_URL=http://searxng:8080 # Optional: Configure network mode (SSE) for LibreChat etc. - SSE_HOST=0.0.0.0 - SSE_PORT=8080 # Optional: Set a custom User-Agent for web requests - USER_AGENT=MCP-Server/1.0 (github.com/tcpipuk/mcp-server) image: ghcr.io/tcpipuk/mcp-server/server:latest ports: # Only needed if using SSE_HOST/SSE_PORT - "8080:8080" # Expose port 8080 on host restart: unless-stopped stop_grace_period: 1s # Example SearXNG service (optional, adapt as needed) # searxng: # environment: # - SEARXNG_BASE_URL=http://searxng:8080 # Ensure SearXNG knows its own URL # image: searxng/searxng:latest # restart: unless-stopped # volumes: # - ./searxng:/etc/searxng:rw
重要提示：您必须提供SEARXNG_QUERY_URL环境变量，指向 SearXNG 实例的搜索 API 端点（通常以/或/search结尾）。
设置SSE_HOST和SSE_PORT可启用网络模式（服务器发送事件），推荐用于像 LibreChat 这样的多容器设置。如果省略，服务器将使用标准 I/O。
运行docker compose up -d来启动服务器容器（以及可选的 SearXNG）。

大多数人会将其与以下任一方式一起使用：

Claude Desktop - 通过 stdio 直接连接（省略docker-compose.yml中的SSE_HOST / SSE_PORT ）。
LibreChat——通过 SSE 连接网络。

对于 LibreChat，将其添加到您的librechat.yaml （假设SSE_PORT=8080 ）：

mcpServers: mcp-server: iconPath: "/path/to/icon.png" # Optional: Custom icon label: "MCP Web/Search" # Optional: Custom label shown in UI type: sse url: http://mcp-server:8080/sse # Adjust host/port if needed

💻本地运行

安装uv （需要 Python 3.13+）：
curl -LsSf https://astral.sh/uv/install.sh | sh
**注意：**如果您已经安装了uv ，请使用uv self update进行更新。
创建并激活虚拟环境：
uv venv source .venv/bin/activate # Linux/macOS # or .venv\Scripts\activate # Windows
从锁文件安装依赖项：
uv sync
设置所需的环境变量：
# Required: URL for your SearXNG instance's Search API export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080" # Optional: Custom User-Agent export USER_AGENT="CustomAgent/1.0"
运行服务器：
# For network (SSE) mode (e.g., for LibreChat) mcp-server --sse-host 0.0.0.0 --sse-port 3001 # For direct stdio mode (e.g., for Claude Desktop) mcp-server

可用参数：

--sse-host ：SSE 监听地址（例如0.0.0.0 ）。启用 SSE 模式。
--sse-port ：SSE 监听端口（例如3001 ）。启用 SSE 模式。
--user-agent ：自定义用户代理字符串（覆盖USER_AGENT环境变量）。

注意：如果未提供--sse-host或--sse-port SEARXNG_QUERY_URL且未设置SSE_HOST / SSE_PORT环境变量），则服务器默认为stdio模式。SEARXNG_QUERY_URL 环境变量始终为必需。

🔌 如何连接

您可以通过两种方式连接到服务器：

方法	这意味着什么	何时使用
网络连接 (SSE)	服务器在网络端口上监听连接。	最适合 LibreChat 或其他网络客户端。
直接连接（stdio）	服务器通过标准输入/输出直接通信。	对于本地测试或 Claude Desktop 有用。