Skip to main content
Glama
DeepSeek Harness Plugin MCP

DeepSeek Harness Plugin MCP

by bobleer

DeepSeek Harness Plugin MCP

Made by BitFun.

MCP server that lets any agent discover, inspect, install, and run DeepSeek Harness plugins.

Catalog source: github.com/topics/dsh-plugin.

English | 中文

What it does

DSH plugins are Cordis bundles (dsh.bundle.patch → cordis.patch.yml). Foreign agents speak MCP, not Cordis. This server is the inverse of @deepseek-ai/dsh-mcp-client:

Plane

Needs DSH?

What the agent can do

Catalog

No

Search/list/inspect every public dsh-plugin repo, read README and cordis.patch.yml

Profile

dsh on PATH

dsh plugin add / remove into a real profile

Runtime

dsh on PATH + --allow-runtime

Boot that profile and call composition tools as dsh__*

UI/TUI/skin plugins are catalogued and installable. They do not become MCP tools; their UI stays in DSH.

Related MCP server: HMCL MCP Server

Install

npm install -g deepseek-harness-plugin-mcp
# or
npx deepseek-harness-plugin-mcp --help

Node ^22.19 || >=24.

Wire it into an agent

Cursor / Claude Desktop / Claude Code / Codex (stdio)

{
  "mcpServers": {
    "dsh-plugins": {
      "command": "npx",
      "args": ["-y", "deepseek-harness-plugin-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_optional_but_recommended"
      }
    }
  }
}

Enable install and runtime (this runs dsh plugin and plugin code):

{
  "mcpServers": {
    "dsh-plugins": {
      "command": "npx",
      "args": ["-y", "deepseek-harness-plugin-mcp", "--allow-install", "--allow-runtime"],
      "env": {
        "GITHUB_TOKEN": "ghp_…",
        "DSH_PLUGIN_MCP_PROFILE": "mcp-bridge"
      }
    }
  }
}

dsh must be on PATH for the profile and runtime planes.

Streamable HTTP

dsh-plugin-mcp --http --port 8765 --allow-runtime

Point the agent at http://127.0.0.1:8765/mcp. GET /health is a process liveness check.

Inside DeepSeek Harness

This package is itself a DSH bundle:

dsh plugin --profile web add github:bobleer/deepseek-harness-plugin-mcp
dsh --profile web

The live Harness then serves Streamable HTTP MCP (default http://127.0.0.1:8765/mcp) and mirrors ctx.tools — every first-party and third-party tool the composition registered.

MCP tools

Control plane:

  • dsh_plugin_status / dsh_plugin_refresh_catalog / dsh_plugin_list / dsh_plugin_search

  • dsh_plugin_get / dsh_plugin_inspect / dsh_plugin_readme

  • dsh_plugin_list_installed / dsh_plugin_install / dsh_plugin_uninstall

  • dsh_runtime_start / dsh_runtime_stop / dsh_runtime_load / dsh_runtime_unload / dsh_runtime_list_tools

After dsh_runtime_start, DSH tools appear as dsh__<name>.

Resources: dsh-plugin://catalog, dsh-plugin://github/{owner}/{repo} (+ /readme, /package.json, /cordis.patch.yml), dsh-plugin://installed/{profile}, dsh-plugin://runtime/tools.

Prompts: search-dsh-plugins, install-dsh-plugin, use-dsh-plugin.

Flags and env

Flag / env

Default

Meaning

--http

stdio

Streamable HTTP

--host / DSH_PLUGIN_MCP_HOST

127.0.0.1

Bind address

--port / DSH_PLUGIN_MCP_PORT

8765

Bind port

--allow-install / DSH_PLUGIN_MCP_ALLOW_INSTALL

off

dsh plugin add/remove

--allow-runtime / DSH_PLUGIN_MCP_ALLOW_RUNTIME

off

Spawn DSH and bridge tools

--profile / DSH_PLUGIN_MCP_PROFILE

mcp-bridge

Target profile

--dsh-root / DSH_ROOT

unset

Harness checkout (informational in status)

--cache-dir / DSH_PLUGIN_MCP_CACHE_DIR

~/.dsh-plugin-mcp

Catalog cache

--no-catalog / DSH_PLUGIN_MCP_CATALOG=0

on

Disable GitHub catalog tools

GITHUB_TOKEN / GH_TOKEN

unset

GitHub API auth

Install and runtime are off until you opt in. Catalog is always available.

Typical agent flow

  1. dsh_plugin_search with the task keywords.

  2. dsh_plugin_inspect on owner/repo. Prefer isDshBundle: true.

  3. Optional: dsh_plugin_install with github:owner/repo.

  4. dsh_runtime_start with plugins: ["github:owner/repo"].

  5. Call the listed dsh__* tools.

Development

npm install
npm run check

Protocol smoke (official MCP Inspector CLI, same client family as @modelcontextprotocol/sdk):

npx @modelcontextprotocol/inspector --cli node dist/cli.js --method tools/list
npx @modelcontextprotocol/inspector --cli node dist/cli.js --method tools/call \
  --tool-name dsh_plugin_status --tool-args-json '{}'

Design: docs/design.md.

License

MIT

Available Tools

15 tools
dsh_plugin_getA

Get one catalog card by owner/repo, github:owner/repo, or GitHub URL.

Inputs: spec (required).

dsh_plugin_inspectC

Inspect package.json, cordis.patch.yml, README, skills, and DSH bundle metadata for one plugin.

Inputs: spec (required).

dsh_plugin_installA

Install a plugin into the DSH profile via dsh plugin add. Requires --allow-install.

Inputs: spec (required).

dsh_plugin_listB

List cached dsh-plugin repositories. Call dsh_plugin_refresh_catalog if the cache is empty or stale.

Inputs: kind, limit, query, offset, +3 more.

dsh_plugin_list_installedA

List bundles and dependencies installed in the configured DSH profile.

Inputs: no named parameters.

dsh_plugin_readmeC

Return the full README of a dsh-plugin repository.

Inputs: spec (required).

dsh_plugin_refresh_catalogA

Force-refresh the GitHub topic:dsh-plugin catalog and replace the on-disk cache.

Inputs: no named parameters.

dsh_plugin_statusA

Report GitHub auth, catalog cache, dsh binary, profile, and runtime bridge status.

Inputs: no named parameters.

dsh_plugin_uninstallC

Remove a plugin from the DSH profile via dsh plugin remove. Requires --allow-install.

Inputs: packageName (required).

dsh_runtime_list_toolsA

List DSH tools currently bridged onto this MCP server as dsh__* names.

Inputs: no named parameters.

dsh_runtime_loadC

Install one more plugin into the live profile and restart the DSH runtime. Requires --allow-runtime.

Inputs: spec (required).

dsh_runtime_startA

Install this MCP bundle plus optional plugins into the profile, spawn dsh --profile, and bridge ctx.tools as dsh__* MCP tools. Requires --allow-runtime.

Inputs: plugins.

dsh_runtime_stopA

Stop the spawned DSH runtime and drop bridged dsh__* tools.

Inputs: no named parameters.

dsh_runtime_unloadA

Remove a package from the live profile and restart the DSH runtime. Requires --allow-runtime.

Inputs: packageName (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 15 tools

    Disambiguation4/5

    Tools are clearly separated into plugin catalog, profile, and runtime operations, but there is slight overlap between list/search and install/runtime_load. Descriptions are detailed enough to resolve ambiguity in most cases.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with the dsh_ prefix, using verb phrases like get, list, install, uninstall, start, stop. The only minor deviation is dsh_plugin_status, which is a noun, but overall naming is highly predictable.

    Tool Count5/5

    15 tools sit at the upper boundary of the ideal range, but each tool maps to a distinct step in the plugin lifecycle (catalog, install, runtime), making the set feel well-scoped and not bloated.

    Completeness4/5

    The tool surface covers catalog browsing, plugin installation/removal, and runtime lifecycle management comprehensively. An update operation is missing, but it can be simulated through uninstall/install, so it is not a critical gap.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A powerful MCP server that brings the skills.sh ecosystem directly to your AI agents, enabling effortless discovery, installation, and management of skills.
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP server that lets AI agents drive HMCL (Hello Minecraft! Launcher) programmatically to install Minecraft versions, search/download/import modpacks from Modrinth/CurseForge, and launch/stop the game.
      13
      3
      -