Introduction¶

When connecting browser capabilities to a DeepSeek Harness (DSH) agent, the common approach is Playwright: a headless environment, an independent automation profile, login state, and cookies completely separated from the user’s daily browser, requiring npx playwright install to be run during setup. If the task requires reusing logged-in sites, this path involves a lot of extra work.

dsh-jiey-browser takes a different approach: it hands over the real Jiey Chromium (the user’s own browser) to the agent via MCP, rather than spinning up another headless environment. Below is an introduction to what this plugin can do, how to install it, and how to use it.

What is it¶

dsh-jiey-browser is a DSH plugin maintained by jiewaigongxing. Its core purpose is defined in one sentence: providing real Jiey Browser tools to DSH agents via MCP. The current version is 0.1.4, released under the MIT license. It depends on @modelcontextprotocol/sdk ^1.30.0 and @deepseek-ai/schemastery ^3.18.1, while @deepseek-ai/cordis (>=4.0.1 <5) is an optional peer dependency.

Note the context: DSH is currently in developer preview. This plugin targets the Cordis / tools + systemPrompt interfaces. If DSH breaks the API, the plugin may need to be updated accordingly.

Core Features¶

The plugin provides 7 tools, each mapping to the corresponding interface in Jiey MCP:

Besides the tools themselves, there are a few designs worth mentioning:

1. Auto Discovery: The plugin discovers the Jiey MCP service in the following order: plugin serverUrl → BROWSEROS_URL / JIEY_URL → ~/.browseros/server.json → http://127.0.0.1:9100.
2. Health Check: GET /system/health must return { status: "ok" }.
3. Isolation: Tab isolation is implemented via the scopeId request header. Cordis dispose will close tabs opened by the plugin.
4. Failure Handling: If Jiey is missing or offline, tools will fail and include the official download page link, rather than silently falling back to another browser.

Installation and Activation¶

First, confirm three things: the Node.js version satisfies ^22.19 || >=24; you have a DSH profile; and Jiey Browser is installed and opened, making its MCP service available (default http://127.0.0.1:9100). Jiey can only be downloaded from the official website: https://www.gongxingglobal.com/browser. macOS / Windows / Linux installers are listed on the official website; the repository itself does not provide CDN links.

Install from npm:

dsh plugin --profile web add dsh-jiey-browser
# or
npm install dsh-jiey-browser

If doing a local checkout, build first then install:

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

Then configure in the profile’s cordis.patch.yml (or DSH settings interface):

- id: jiey-browser
  config:
    serverUrl: ""              # Leave empty = auto discovery
    scopeId: dsh-jiey-browser  # Tab isolation request header
    allowCookies: false        # Default no reuse of login state
    downloadUrl: https://www.gongxingglobal.com/browser
    maxSnapshotChars: 40000

Leaving serverUrl empty uses the auto-discovery chain mentioned above; allowCookies defaults to false. It does not reuse login state or user tabs; it only opens them when the user explicitly requests the agent to use logged-in sites.

Typical Usage¶

You can verify the plugin and Jiey link locally without installing DSH. Start Jiey first, then execute:

npm install
npm run build
npm run smoke

When Jiey is running, the smoke test will open https://example.com, take a snapshot, and then close the tab.

In actual use for an agent, the typical flow is: browser_open opens the page → browser_snapshot gets refs → browser_act performs clicks, form filling, etc.; use browser_read for text content, and browser_screenshot to confirm page state.

Use Cases and Notes¶

Suitable scenarios: Need the agent to open, read, and manipulate web pages in a real browser; want to isolate tabs and auto-clean up on exit; reuse logged-in sites with explicit user consent.

Notes when using:

1. Security: allowCookies defaults to false. Only enable it if the user explicitly requests the agent to use logged-in sites.
2. Offline: If Jiey is offline, tools will fail with the official download page link (default https://www.gongxingglobal.com/browser), with no silent browser fallback.
3. Permissions: The plugin runs with the permissions of the current dsh process. It is recommended to check the source code and license before installing (this project is MIT).
4. API Stability: DSH is in developer preview. The plugin targets Cordis / tools + systemPrompt interfaces and may need updates if DSH breaks the API later.

Conclusion¶

dsh-jiey-browser focuses on a specific goal: integrating the user’s real Jiey browser into DSH as 7 MCP tools, with clear default values for login state, tab isolation, and cleanup strategy. If you are configuring networking capabilities for a DSH agent, check out:

• Community directory page (independent site, no official affiliation with DeepSeek / Hyperscience): https://www.skillhub.cn/plugins/jiewaigongxing/dsh-jiey-browser
• GitHub repository: https://github.com/jiewaigongxing/dsh-jiey-browser