MCP Server
2025.04.09
2
Python网络搜索网页处理开发效率
MCP Server 是一个为AI助手提供增强能力的服务，使其能够安全地访问网站和搜索网络信息。该服务器提供清晰的反馈和有用的错误信息，帮助AI助手更有效地解决实际问题。
View on GitHub
Overview
基本能力
产品定位
MCP Server 旨在为AI助手提供网络访问和搜索能力，使其能够获取实时信息并处理网页内容。
核心功能
- 搜索工具：通过SearXNG搜索网络，获取当前信息、特定资源或进行计算。
- 网页访问工具：访问网站并处理其内容，包括将页面转换为Markdown、获取原始内容或提取链接。
适用场景
- AI助手需要获取实时网络信息时。
- 需要处理网页内容（如转换为Markdown或提取链接）时。
- 在开发环境中集成网络搜索和访问功能时。
工具列表
- Search工具：通过SearXNG进行网络搜索，适用于获取实时信息或特定资源。
- Web工具：访问并处理网页内容，支持转换为Markdown、获取原始内容或提取链接。
常见问题解答
- 如何配置SearXNG：必须提供
SEARXNG_QUERY_URL环境变量，指向SearXNG实例的搜索API端点。 - 网络模式与stdio模式的区别：网络模式（SSE）适用于多容器设置（如LibreChat），而stdio模式适用于本地测试或Claude Desktop。
使用教程
使用依赖
- 安装Docker（推荐）或Python 3.13+（本地运行）。
安装教程
Docker方式（推荐）
- 创建
docker-compose.yml文件并配置环境变量（如SEARXNG_QUERY_URL）。 - 运行以下命令启动服务：
bash docker compose up -d
本地运行方式
- 安装
uv工具：bash curl -LsSf https://astral.sh/uv/install.sh | sh - 创建并激活虚拟环境：
bash uv venv source .venv/bin/activate # Linux/macOS .venv\Scripts\activate # Windows - 安装依赖：
bash uv sync - 设置环境变量并运行服务：
bash export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080" mcp-server --sse-host 0.0.0.0 --sse-port 3001 # 网络模式 mcp-server # stdio模式
调试方式
- 检查Docker容器日志：
bash docker logs mcp-server - 本地运行时查看控制台输出。
- 确保
SEARXNG_QUERY_URL正确配置。