dsh-scan-mcp

Windows MCP Hub for DeepSeek Harness — scans the MCP servers configured in your local coding agents (Claude Code / Codex / CodeBuddy), probes real connectivity with an actual MCP initialize handshake (both stdio and streamable-http transports), and lets you enable/disable each server from the UI.

中文文档 · npm · GitHub

Features

• Auto-scan — reads MCP configs from Claude Code (~/.claude.json), Codex (~/.codex/config.toml) and CodeBuddy (~/.codebuddy/mcp.json), with cross-agent deduplication (same MCP shown once, sources merged).
• Real connectivity probe — starts the actual process (stdio) or performs a real MCP initialize handshake over HTTP (streamable-http, JSON and SSE responses, configurable headers passthrough). Online (green) / offline (red) at a glance, with the concrete failure reason and latency.
• Enabled-only probing — only enabled MCPs are ever connected. Disabled servers show as offline (已停用（未启用，不检测连接）) and are never probed; re-enabling auto re-tests.
• Per-server reconnect — re-test one server without a full rescan (disabled servers: button greyed out).
• Sliding toggles — all servers enabled by default; toggle any off/on. State persists to ~/.dsh/dsh-scan-mcp.json (survives restarts).
• /mcp popup panel — type /mcp in any session to open a modal control panel (not an AI reply).
• Settings section — Settings → Windows MCP 控制中心 (card layout).
• Model tool — exposes mcp_discovered_catalog (scan + connectivity, read-only).

Requirements

• Windows (the scanned agent configs live under the Windows user home)
• DeepSeek Harness (DSH) with a web profile (dsh web)
• Node.js ≥ 20 (the host half uses the built-in fetch for streamable-http probes)

Installation

Pick one of the following commands (replace <profile-name> with your DSH profile name, e.g. web):

# 1. From npm (recommended)
dsh plugin --profile <profile-name> add dsh-scan-mcp

# 2. From GitHub
dsh plugin --profile <profile-name> add https://github.com/chenbin-dev/dsh-scan-mcp.git

# 3. Local development
dsh plugin --profile <profile-name> add /path/to/dsh-scan-mcp

Then restart the profile (e.g. stop and run dsh web again). The plugin is a static bundle: it survives DSH restarts and needs no per-session approval prompt.

Usage

1. In any session, type /mcp → the MCP control panel pops up:
   • Summary row: deduped MCP count · online · offline · disabled · diagnostics
   • Each row: name, transport (stdio / streamable-http) · endpoint, ● online / ● offline, failure reason, Reconnect button (greyed out when disabled), sliding toggle
   • Header: refresh scan / close
2. Or open Settings → Windows MCP 控制中心 for the same data in card layout.
3. The model can also call the mcp_discovered_catalog tool for the full catalog.

Scan sources

Agent	Config file	Format
Claude Code	~/.claude.json	JSON mcpServers object
Codex	~/.codex/config.toml	TOML [mcp_servers.<name>] sections
CodeBuddy	~/.codebuddy/mcp.json	JSON

Missing/unreadable files show up in the panel's diagnostics counter and don't break the rest of the scan. Want more sources? Edit the SOURCES array at the top of src/index.js (or open a PR / an issue).

Transport support

…