hermes-web-mcp
无需 API 密钥的 MCP 服务器，为 DSH 和任何 MCP 客户端提供 web_search、web_extract 以及 7 个 page_* 真实浏览器（CDP）工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ShadowMiner/hermes-web-mcp#11e7937903ef6fe12f032999103a8cd1fa5b8344Hermes Web Mcp 以 hermes-web-mcp 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Web powers for any MCP client — no API keys required.
hermes-web-mcp is an MCP (Model Context Protocol) server that gives DSH Desktop and any MCP client a complete web toolkit:
page_open, page_click, page_type, page_read, page_shot, page_back, page_close.| Tool | Purpose | Key arguments |
|---|---|---|
web_search | Keyless web search (cn.bing direct, DDG fallback) → title/URL/snippet list | query (string, required), max_results (number, default 8) |
web_extract | Render + scrape a page to Markdown via playwright-service + html-to-md; dual-CDP failover, then plain-fetch degrade | url (required), via_proxy (boolean), wait_ms (number, default 2500) |
page_open | Open a URL in the shared CDP Chrome; returns the first 4000 chars of body text | url (required), via_proxy (boolean), wait_ms (default 3000) |
page_click | Click an element matched by a CSS selector | selector, wait_ms (default 1200) |
page_type | Fill an input field (optionally press Enter) | selector, text, enter (boolean) |
page_read | Read up to 12000 chars of the current page body | — |
page_shot | Screenshot the current page into shots/ and return the file path | full_page (boolean) |
page_back | Navigate back one page | — |
page_close | Close the isolated browser context (cleanup) | — |
9 tools in total: web_search + web_extract + 7 page_* tools.
┌──────────────┐ stdio (MCP) ┌────────────────────── hermes-web-mcp ──────────────────────┐
│ MCP client │ ───────────────▶ │ web_search → cn.bing (keyless) / DDG fallback │
│ (DSH, etc.) │ │ web_extract → playwright-service (:3003) → html-to-md │
└──────────────┘ │ (:8080) ⇄ CDP Chrome 9333 (direct) / │
│ 9334 (via HTTP proxy) │
│ page_* → playwright chromium.connectOverCDP │
└───────────────────────────────────────────────────────────┘
web_extract never needs a scraper API key: a local playwright-service renders the page over CDP, and an html-to-md service converts the HTML to Markdown. Two Chrome instances back it:
127.0.0.1:9333) — for domestic sites and pages where your normal login session lives.127.0.0.1:9334) — Chrome with traffic routed through your local HTTP proxy, for overseas/restricted sites.web_extract tries your preferred CDP first and fails over to the other automatically; if both fail it degrades to a plain fetch (no JS rendering). The page_* tools use Playwright's connectOverCDP against the same shared Chrome in an isolated context — host tabs are never touched.
| Variable | Default | Meaning |
|---|---|---|
WEBMCP_PW | D:/path/to/playwright-service/node_modules/playwright | Path to a Playwright install whose chromium driver is used for connectOverCDP |
WEBMCP_SCRAPE | http://127.0.0.1:3003/scrape | playwright-service scrape endpoint (POST {url, wait_after_load, cdp_url} → {content, pageStatusCode, contentType}) |
WEBMCP_CONVERT | http://127.0.0.1:8080/convert | html-to-md endpoint (POST {html} → {markdown}) |
WEBMCP_CDP_DIRECT | http://127.0.0.1:9333 | CDP endpoint of the direct Chrome |
WEBMCP_CDP_PROXY | http://127.0.0.1:9334 | CDP endpoint of the proxied Chrome |
All variables are optional — omit them and the defaults above are used.
npm install in this repo (only runtime dependency: @modelcontextprotocol/sdk).POST /scrape {url, wait_after_load, cdp_url} → {content, pageStatusCode, contentType}, rendering the page with Playwright against the target CDP. (The firecrawl-lite project has a reference implementation.)POST /convert {html} → {markdown}.chrome --remote-debugging-port=9333 (direct)chrome --remote-debugging-port=9334 launched with traffic routed through your local HTTP proxy (for sites not directly reachable).WEBMCP_PW (or the default path) for the page_* tools.The defaults assume services on
127.0.0.1:3003/127.0.0.1:8080and Chrome on9333/9334. Different setup? Just set the env vars.
Generic MCP config (e.g. Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"hermes-web": {
"command": "node",
"args": ["D:/path/to/hermes-web-mcp/hermes-web-mcp.js"],
"env": {
"WEBMCP_PW": "D:/path/to/playwright-service/node_modules/playwright",
"WEBMCP_SCRAPE": "http://127.0.0.1:3003/scrape",
"WEBMCP_CONVERT": "http://127.0.0.1:8080/convert",
"WEBMCP_CDP_DIRECT": "http://127.0.0.1:9333",
"WEBMCP_CDP_PROXY": "http://127.0.0.1:9334"
}
}
}
}
dsh-mcp-client (SQLite registry, insert example — adapt column names to your schema):
INSERT INTO mcp_servers (name, command, args, env) VALUES (
'hermes-web',
'node',
JSON_ARRAY('D:/path/to/hermes-web-mcp/hermes-web-mcp.js'),
JSON_OBJECT(
'WEBMCP_PW', 'D:/path/to/playwright-service/node_modules/playwright',
'WEBMCP_SCRAPE', 'http://127.0.0.1:3003/scrape',
'WEBMCP_CONVERT', 'http://127.0.0.1:8080/convert',
'WEBMCP_CDP_DIRECT', 'http://127.0.0.1:9333',
'WEBMCP_CDP_PROXY', 'http://127.0.0.1:9334'
)
);
With all prerequisites running:
npm install
node smoke.js
smoke.js spawns the server over real MCP stdio, lists the registered tools, then calls web_search, web_extract, page_open (proxied) and page_shot, printing each output. It requires the playwright-service, the html-to-md service and both CDP Chrome instances to be up.
MIT — Copyright (c) 2026 ShadowMiner.