online-search-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ALL_PROXY | No | Fallback proxy for all requests. By default the service follows the Windows system proxy; this overrides it. | |
| DDGS_PROXY | No | Proxy used only for search (takes precedence over HTTPS_PROXY/HTTP_PROXY/ALL_PROXY). e.g. socks5://127.0.0.1:1080 | |
| HTTP_PROXY | No | Proxy for HTTP requests. By default the service follows the Windows system proxy; this overrides it. | |
| SEARCH_RPM | No | Self-imposed limit for search_web in requests per minute | 6 |
| HTTPS_PROXY | No | Proxy for HTTPS requests. By default the service follows the Windows system proxy; this overrides it. e.g. http://127.0.0.1:7890 | |
| GITHUB_TOKEN | No | GitHub API token to raise the search_github rate limit from 10 to 30 requests/minute | |
| FETCH_BROWSER | No | Set to 'off' to disable the headless browser fallback for fetch_url_content | on |
| FETCH_CACHE_MAX | No | Maximum number of entries in the fetch cache | 64 |
| FETCH_CACHE_TTL | No | Fetch cache TTL in seconds; set to 0 to disable | 300 |
| SEARCH_CACHE_MAX | No | Maximum number of entries in the search cache | 32 |
| SEARCH_CACHE_TTL | No | Search cache TTL in seconds; set to 0 to disable | 300 |
| FETCH_BROWSER_TIMEOUT | No | Timeout in seconds for the headless browser fallback | 20 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_webA | 联网搜索(DuckDuckGo),返回带链接的结果列表。 Args: query: 搜索关键词,支持中英文。 max_results: 返回条数上限,默认 8(1-20)。 timelimit: 时效性过滤:None 不限 / "d" 一天 / "w" 一周 / "m" 一月 / "y" 一年。新闻类查询建议 "w" 或 "d"。 region: 地区语言偏好:"wt-wt" 全球 / "cn-zh" 中文 / "us-en" 美国英文。 fetch_top: 同时抓取前 N 条(0-3)结果的正文摘要(各约 800 字,并发纯 HTTP)。 需要直接答案、不想再逐条 fetch 时设 2-3;默认 0 保持低延迟。 |
| fetch_url_contentA | 抓取网页正文并转为 Markdown(自动去导航/广告,处理中文编码)。 5 分钟内重复抓取同一 URL 直接命中缓存。发生重定向时结尾标注最终 URL。 Args: url: 目标网址(http/https)。 max_chars: 返回正文最大字符数,默认 20000,超出截断并标注。 render_mode: "auto"(默认,HTTP 优先、失败时无头浏览器兜底)/ "request"(强制纯 HTTP,最快,不启动浏览器)/ "browser"(强制无头浏览器渲染,已知是 JS 页面时用,省一次无效 HTTP)。 |
| search_githubA | 搜索 GitHub 仓库(官方 API,找开源项目/案例/轮子用这个)。 支持限定符组合,示例: - "mcp server language:python stars:>1000"(Python 高星 MCP 服务) - "rimworld mod topic:rimworld-mod"(按主题) - "web crawler pushed:>2025-01-01 language:go"(近期活跃的 Go 爬虫) 常用限定符:language: / stars:>N / topic: / pushed:>YYYY-MM-DD / license: / in:name,description Args: query: 搜索词,可含上面的限定符。 max_results: 返回条数上限,默认 8(1-20)。 sort: "best-match"(相关度)/ "stars" / "forks" / "updated"。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
The three tools have clearly distinct targets: web search, single-URL content extraction, and GitHub repository search. The only mild overlap is that search_web's fetch_top option also retrieves page snippets, which could occasionally be confused with fetch_url_content, but the description frames it as a low-latency convenience rather than a replacement.
All three names follow the same snake_case verb_object pattern (search_web, fetch_url_content, search_github). The verbs are predictable and the object noun clearly identifies the resource or action, so an agent can infer behavior from the name alone.
Three tools is a tight, well-scoped surface for a search-and-retrieve server, with no redundant or filler entries. Each tool maps to a distinct step in the research workflow (discover, read, find code), so nothing feels missing or excessive within this scope.
The search-then-fetch loop is fully covered, including GitHub-specific discovery, so agents can complete most research tasks without dead ends. Minor gaps remain: no batch multi-URL fetch, no pagination beyond max_results, and no alternative search backends if DuckDuckGo fails.