🚀 与Searx搜索引擎集成的简单MCP服务器
这是一个用于与Searx搜索引擎集成的简单MCP（机器控制协议）服务器。该服务器允许通过MCP协议连接到Searx，并支持多种配置选项以满足不同的需求。
🚀 快速开始
本项目是一个简单的MCP服务器，可与Searx搜索引擎集成。以下将详细介绍其安装、配置、使用、开发、发布等方面的内容。
📦 安装指南
使用pip安装
pip install searxng-simple-mcp
使用Docker安装
docker pull yourusername/searxng-simple-mcp:latest
🛠️ 配置说明
通过设置以下环境变量来配置服务器的行为：
| 属性 | 详情 |
|---|---|
SEARXNG_MCP_SEARXNG_URL |
Searx搜索引擎的URL（默认值为https://searx.info） |
SEARXNG_MCP_TIMEOUT |
与Searx通信的超时时间（以秒为单位，建议值为30） |
SEARXNG_MCP_MAX_RESULTS |
每次查询的最大结果数（建议值为20） |
SEARXNG_MCP_LANGUAGE |
搜索语言（默认值为all） |
SEARXNG_MCP_ENABLE_TAG_FILTERS |
启用或禁用标签过滤功能（值为true或false，默认值为true） |
SEARXNG_MCP_TAG_BLACKLIST |
要排除的标签列表，以逗号分隔 |
SEARXNG_MCP_TAG_WHITELIST |
允许使用的标签列表，以逗号分隔 |
💻 使用示例
基础用法
使用pip安装的方式运行
searxng-simple-mcp run --searx-url https://example.com --timeout 30 --max-results 20 --language all --enable-tag-filters true --tag-blacklist adult,spam --tag-whitelist news,tech
使用Docker安装的方式运行
docker run -e SEARXNG_MCP_SEARXNG_URL=https://example.com -e SEARXNG_MCP_TIMEOUT=30 -e SEARXNG_MCP_MAX_RESULTS=20 -e SEARXNG_MCP_LANGUAGE=all -e SEARXNG_MCP_ENABLE_TAG_FILTERS=true -e SEARXNG_MCP_TAG_BLACKLIST=adult,spam -e SEARXNG_MCP_TAG_WHITELIST=news,tech yourusername/searxng-simple-mcp:latest
🔨 开发指南
安装依赖项
uv pip install -e .
运行服务器
python -m src.searxng_simple_mcp.server
🚀 发布到PyPI
安装开发依赖项
npm run install:deps
构建和检查包
npm run build:package
npm run check:package
发布到PyPI
npm run publish:pypi
🐳 Docker配置
注意事项
⚠️ 重要提示
- 使用
--network=host选项以访问主机上的服务。- 使用
-p 8000:8000选项以将SSE服务器暴露到网络。
📁 项目结构
searxng-simple-mcp/
├── src/
│ ├── run_server.py # 入口脚本
│ └── searxng_simple_mcp/ # 包含主要实现的模块
├── README.md # 项目文档
└── setup.py # 安装脚本
👥 贡献说明
欢迎任何人提交问题、拉取请求或提出建议。请在GitHub仓库中查看具体的贡献指南。
此文档详细介绍了如何安装、配置和使用Searx MCP服务器，并提供了开发和发布的相关信息。如需进一步帮助，请参考项目仓库中的更多资源。