DeepSeek Web Harness

Use an authenticated DeepSeek Web session as a local MCP tool from MCP-capable AI harnesses and third-party clients.

Step 1 flow:

MCP-capable harness / third-party client
              |
              v
      deepseek-web-harness
              |
      local SKILL.md injection
              |
              v
  signed-in normal Chrome profile
              |
              v
        DeepSeek Web
              |
              v
          response

The first login is manual in a normal installed Chrome/Edge window. The bridge then reuses that dedicated browser profile. It does not copy cookies or credentials into the repository.

Setup

npm install
npm run login

Sign in to DeepSeek in the browser that opens, then close that browser normally.

Verify direct chat:

npm run chat -- "Reply with exactly: DEEPSEEK WEB READY"

Start the MCP server:

npm run mcp

Generic MCP stdio config:

{
  "mcpServers": {
    "deepseek-web": {
      "command": "node",
      "args": ["E:/projects/deepseek-web-harness/server/index.js"]
    }
  }
}

Tools:

• ask_web_deepseek — prompt DeepSeek Web and return its final text. Supports mode (instant, expert, imageRecognition), deepThink, search, newChat, attachments, and local skills.

• deepseek_web_capabilities — inspect the signed-in Web UI for DeepThink, search, and file-upload support.

• list_deepseek_skills — list local skills.

ask_web_deepseek accepts skills, for example ["concise"]. Skills live at skills/<name>/SKILL.md and are prepended to the prompt. attachments takes absolute local file paths and uploads them to DeepSeek Web before the prompt is sent. The bridge also maps the current Web UI controls for Instant, Expert, Image Recognition, DeepThink, and Smart Search.

The current signed-in Web UI advertises uploads for common images (png, jpg, webp, gif, svg), PDFs, Office documents, spreadsheets, text/Markdown/CSV/JSON, source-code files, and several additional document/image formats. Use deepseek_web_capabilities to read the live accept list instead of hard-coding it in clients.

CLI examples:

npm run chat -- "Explain this carefully" --mode expert --deep-think --new-chat
npm run chat -- "What is in this file?" --mode imageRecognition --attach C:\path\image.png --new-chat
npm run chat -- "Find the latest information about this topic" --search --new-chat

Related MCP server: cdp-bridge

Credits

Inspired by miuuyy/codex-chatgpt-web, especially its local bridge -> owned browser session -> web AI response pattern. This project is a separate DeepSeek-oriented implementation.

Notes

• Windows is the Step 1 target.

• Chrome or Edge must be installed.

• If the site asks for verification or login again, run npm run login and complete it manually.

• Browser/site UI changes can require selector updates.

MIT licensed.