enilmalus/offline_websearch

README 摘要

offline websearch 一个本地部署、基于 DuckDuckGo 的 Web 搜索 MCP server 。无需 API key、不依赖 Deepseek 服务端，把 web search 工具以标准 MCP 协议暴露给任意 MCP 客户端（DeepSeek Harness / DSH、Claude Code 等）。 - ✅ 无需 API key - ✅ 无 Anthropic 依赖 - ✅ 本地客户端侧搜索（只用 DuckDuckGo 及其回退引擎） - ✅ 域名 allow/block 过滤（含子域） 它解决什么问题 Deepseek harness 原生的 WebSearch 工具依赖 Deepseek 服务端的能力，只在官方 / Vertex / Foundry 后端可用。当你把 agent 跑在第三方模型网关上（DeepSeek、Ollama、自建代理……）时，原生 WebSearch 会静默失败。本 server 把搜索放到客户端本地做，绕过这个依赖，而且免 key。 工作原理 底层 ddgs 是 多引擎元搜索 ：并行查询 DuckDuckGo、Brave、Yahoo、Startpage、Wikipedia、Mojeek、Grokipedia，合并去重后返回。只要其中一部分引擎可达，就能出结果。 环境要求 - Python ≥ 3.10 - 机器能访问上述搜索引擎（见「常见问题」里关于超时的说明） 安装（clone 之后） 按你的环境三选一： 装完会得到一个 offline-websearch 命令： - 方式 A 落在 /.local/bin/offline-websearch （需确保 /.local/bin 在 PATH ）。 - 方式 B 落在 .venv/bin/offline-websearch 。 验证安装： 依赖说明 ： pyproject.toml 已把 mcp 钉在 =1.2.0, ）。 @deepseek-ai/dsh-mcp-client 随 DSH 的 dsh 包（ apps/cli ）一起发布，一般无需单独安装。若 boot 时报解析不到，先 dsh plugin --profile web add @deepseek-ai/dsh-mcp-client 。 Claude Code（可选） 如果装进了 venv，就用 venv 里的绝对路径： 工具 API 参数 类型 默认 说明 query string — 搜索词（必填） max results int 8 返回条数（自动截断到 1–20） allowed domains string[] null 只保留这些域名（子域也匹配） blocked domains string[] null 排除这些域名 region string wt-wt 地区码（ w…

分类