dsh-mcphub

中文 | English

한국어

MCP 관리 패널 (DeepSeek Harness 플러그인). 설정 패널에 MCP 섹션을 추가합니다:

• 연결 상태: 초록 점 = 해당 서버의 도구가 현재 세션에 등록됨 (AI가 호출 가능); 회색 점 = 구성되었지만 도구가 등록되지 않음. 전송 유형(stdio / HTTP), 대상 주소, 도구 개수 및 샘플을 표시합니다.

• 업그레이드 관리: pip으로 설치된 stdio 서버(예: scrapling)를 자동 감지하여 PyPI 최신 버전과 비교하고 '업그레이드 가능' 배지를 표시하며, 한 번의 클릭으로 pip install --upgrade를 실행합니다 (Windows 파일 잠금 자동 처리: 점유 프로세스 중지 + 이전 exe 임시 저장); npx 기반 서버는 npx 캐시 실제 버전과 비교하여 '캐시 새로고침' 제공; @latest 유형(시작할 때마다 자동으로 최신 버전 가져오기)은 반복 알림 없음.

• 서버 추가: serverName / transport / URL+headers 또는 command+args+env를 입력하는 양식으로, profile의 cordis.patch.yml에 추가로 기록됩니다 (DSH 재시작 후 적용).

• 연결 테스트: HTTP 서버는 실제 MCP initialize 핸드셰이크를 보냅니다 (serverInfo 및 지연 시간 표시); stdio 서버는 실행 파일 존재 여부를 확인합니다.

• 사용 설명: 도구 명명 규칙 (mcp__<서버명>__<도구명>), AI가 호출하는 방법, 수동 구성 예시, 비밀 키 보안 알림, 문제 해결 가이드.

설치

# 从 GitHub
dsh plugin --profile web add github:jinhongxun/dsh-mcphub

# 或从 npm（如已发布）
dsh plugin --profile web add dsh-mcphub

설치 후 DSH를 재시작해야 적용됩니다.

개인정보

구성 파일의 headers / env 키는 호스트 메모리에서만 프로브(probe) 목적으로 사용되며, 브라우저로 전송되지 않습니다 (패널은 키 이름만 수신).

자주 묻는 질문: profile이란 무엇인가요?

profile은 DSH의 '독립 구성 환경'입니다 (브라우저의 다중 사용자 프로필과 유사): 각 profile은 자체 플러그인과 MCP 목록을 가지며 서로 영향을 주지 않습니다. 예: 한 머신에 web (일상 웹 버전)과 open-design (디자인 소프트웨어용) 두 세트를 두고 각각 MCP를 구성할 수 있습니다. 추가 양식의 profile 선택은 어떤 환경에 기록할지 결정합니다 — profile이 하나만 있으면 신경 쓸 필요가 없습니다.

환경 요구 사항

• Node.js ≥ 20

• DeepSeek Harness (공식 배포판에 dsh-client-connection 채널 포함)

상태는 어떻게 계산되나요?

초록 점/회색 점은 플러그인이 자체적으로 유지하는 상태가 아닙니다: 플러그인은 실행 중인 도구 등록 테이블을 읽어, 특정 서버에 mcp__<서버명>__* 도구가 등록되어 있으면 연결된 것으로 간주합니다. 장점은 침입성이 없고 항상 실제 능력과 일치한다는 점입니다. 경계 사례: '연결되었지만 0개의 도구가 노출됨'은 회색 점으로 표시됩니다. 모든 구성 변경 (추가/일시 중지/삭제/업그레이드)은 DSH 재시작 후 적용됩니다.

스크린샷

추가 예정: 설정 패널 → MCP 섹션 스크린샷.

호환성

Windows / macOS / Linux 모두에서 실행 가능 (업그레이드 동작은 플랫폼별로 분기: PowerShell ↔ pkill, where ↔ command -v, npm 캐시 경로 자동 감지).

English

MCP management panel for DeepSeek Harness. Adds an MCP section to the settings panel:

• Connection status: a green dot means the server's tools are registered in the live session (callable by the AI); grey means configured but not registered. Shows transport (stdio / HTTP), target, tool counts and samples.

• Upgrades: detects pip-installed stdio servers (e.g. scrapling), compares against PyPI, and upgrades in one click — including Windows file-lock handling (stop holders, park the old exe, restore on failure). npx-based servers are compared against the actual npx cache with a "refresh cache" action; @latest specs are never nagged (they self-update).

• Add servers: a form that appends proper cordis.patch.yml entries (serverName / transport / URL+headers or command+args+env). Takes effect after a DSH restart.

• Connectivity probe: HTTP servers get a real MCP initialize handshake (serverInfo + latency); stdio servers get an executable check.

• Help: tool naming (mcp__<server>__<tool>), how to invoke tools via the AI, manual config example, secret-safety notes, troubleshooting.

Install

# from GitHub
dsh plugin --profile web add github:jinhongxun/dsh-mcphub

# or from npm (once published)
dsh plugin --profile web add dsh-mcphub

Restart DSH after installing.

Privacy

Secrets in headers / env stay in the host process for probing only — they are never sent to the browser (the panel receives key names only).

FAQ: what is a profile?

A profile is DSH's isolated config environment (like browser profiles): each one keeps its own plugins and MCP server list. Example: a machine can have web (daily web UI) and open-design profiles, each with its own MCP servers. The profile picker in the add-server form decides which environment gets the new entry — with a single profile there is nothing to choose.

Requirements

• Node.js ≥ 20

• DeepSeek Harness (ships the dsh-client-connection channel in official builds)

Compatibility

Works on Windows / macOS / Linux (upgrade actions branch per platform: PowerShell ↔ pkill, where ↔ command -v, npm cache path auto-detected).

License

MIT