dsh-jiey-browser
开发工具 活跃维护

dsh-jiey-browser

jiewaigongxing/dsh-jiey-browser

遵循MCP协议开发的捷浏览器控制插件,可直接通过标准化接口调用捷浏览器的页面访问、元素定位、交互执行等能力,无需额外适配即可接入MCP生态工具,高效完成浏览器自动化任务编排。

1
Stars 标星
0
Forks 分支
1
Watchers 关注
0
Open Issues
TypeScript
主要语言
MIT
开源协议
43 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:jiewaigongxing/dsh-jiey-browser
git clone https://github.com/jiewaigongxing/dsh-jiey-browser.git
git clone git@github.com:jiewaigongxing/dsh-jiey-browser.git
README.md main

dsh-jiey-browser

DeepSeek Harness plugin that gives the agent real Jiey Browser tools over MCP.

Let DeepSeek Harness go online — one plugin, powered by Jiey.

DSH is in developer preview; this plugin targets the Cordis / tools + systemPrompt surface and may need updates as DSH breaks APIs.

Why Jiey (not Playwright)

Playwright plugins dsh-jiey-browser
Runtime Headless / automation profile Real Jiey Chromium (user browser)
Install funnel npx playwright install Missing Jiey → download guide
Cookies / login Separate profile Default off; opt-in to reuse sessions
Cleanup Controller close Cordis dispose closes owned tabs

Install

Requires Node.js ^22.19 || >=24 and a DSH profile.

# from npm (public)
dsh plugin --profile web add dsh-jiey-browser
# or
npm install dsh-jiey-browser

From a local checkout after npm run build:

dsh plugin --profile web add /absolute/path/to/packages/dsh-jiey-browser

Source: https://github.com/jiewaigongxing/dsh-jiey-browser
npm: https://www.npmjs.com/package/dsh-jiey-browser
Topics: dsh-plugin, deepseek-harness, dsh.

Prerequisites

Full guide: Use with DeepSeek Harness

  1. Install and open Jiey Browser so its MCP server is up (default http://127.0.0.1:9100).
  2. Discovery order: plugin serverUrl → BROWSEROS_URL / JIEY_URL → ~/.browseros/server.json → http://127.0.0.1:9100.
  3. Health check: GET /system/health must return { status: "ok" }.

If Jiey is offline, tools fail with a link to the official download page (default https://www.gongxingglobal.com/browser) instead of silently falling back to another browser.

Configure

In the profile cordis.patch.yml (or DSH settings UI):

- id: jiey-browser
  config:
    serverUrl: ""              # empty = auto-discover
    scopeId: dsh-jiey-browser  # tab isolation header
    allowCookies: false        # DEFAULT: do not reuse login / user tabs
    downloadUrl: https://www.gongxingglobal.com/browser
    maxSnapshotChars: 40000

Security: allowCookies defaults to false. Turn it on only when the user explicitly wants the agent to use existing logged-in sites.

Tools

Tool Maps to Jiey MCP Role
browser_open tabs new + snapshot Open
browser_navigate navigate Navigate
browser_snapshot snapshot Refs for act
browser_read read Markdown / text scrape
browser_act act click / fill / press / …
browser_screenshot screenshot Inline image (no temp file)
browser_tabs tabs list/close List / dispose

Local smoke (no DSH)

npm install
npm run build
npm run smoke

With Jiey running, smoke opens https://example.com, snapshots, and closes the tab.

License

MIT