cander0815/dsh-computer-mcp ↗★ 0

dsh-computer-mcp

通过MCP协议远程操作另一台电脑的文件与命令 适合需要跨设备管理文件、编辑代码或在远程主机上执行命令的控制任务。

套件
dsh-computer-mcp
相容性
待驗證
版本
0.0.1
授權
MIT
最近更新
2026年10月15日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:cander0815/dsh-computer-mcp

2. 安装 DSH 插件并配置 MCP

本仓库同时提供可安装的 DeepSeek Harness Profile Bundle(dsh-plugin)。电脑端程序运行在要操作的电脑上,配置型 bundle 安装在运行 Harness 的环境中;安装插件不会自动安装或启动电脑端程序。

已验证的组合为 Node.js 24 和 DSH 0.2.0-rc.2,使用 DSH 自带的官方 @deepseek-ai/dsh-mcp-client。在已安装 dsh 命令的环境中执行:

dsh plugin --profile web add github:cander0815/dsh-computer-mcp

这是 GitHub 源码安装,当前未发布同名 npm 注册表包。该 bundle 不含 prepare 或其他安装时构建脚本,不需要授权构建。若使用不同 profile,请将 web 换为实际 profile 名称。

随后将电脑配置页下载的配对文件中的 url 和 token 设置为 Harness 进程的环境变量。以下为 POSIX Shell 示例,只使用占位符:

export DSH_COMPUTER_MCP_URL='http://:18790/mcp'
export DSH_COMPUTER_MCP_TOKEN=''
dsh --profile web

Windows PowerShell 示例:

$env:DSH_COMPUTER_MCP_URL = 'http://:18790/mcp'
$env:DSH_COMPUTER_MCP_TOKEN = ''
dsh --profile web

两个变量未完整填写时插件保持禁用,不尝试连接。必须设置在 Harness 进程的启动环境中,不要放进项目 .env 文件。后台服务或容器部署需将环境变量写入相应的私有启动配置,并安装到同一个持久 profile。令牌不要提交到公共仓库或发在投稿内容中。

如果此前已手工加载配置页生成的 local-computer patch,请先停用旧 patch,再使用 bundle,避免重复注册相同服务器名称。也可以继续使用原有手工 patch 接入方式;两种方式选一种即可。

修改配置或升级后,让 Harness 重新连接 MCP,刷新工具列表;必要时重启相应的 Harness 实例。

3. 告诉 AI 使用目标电脑的工具

可以在新会话中这样说明:

请使用 localcomputer MCP 操作连接的电脑。先调用 list_roots,确认设备、授权目录和当前权限,再使用对应的文件或命令工具。不要用 Harness 自带的服务器工具代替;找不到 MCP 工具时请明确告诉我。

Harness 原有工作区选择器仍显示 Harness 所在环境的目录。目标电脑文件通过 MCP 工具访问,不会自动出现在原工作区选择器中。

网络与配置

默认 MCP 端口为 18790,本地配置页端口为 18791。Harness 所在环境必须能访问目标电脑的 MCP 端口;防火墙、路由器客户端隔离和网络路由可能影响连接。使用 Tailscale 时,两端必须在线并允许互访。

HTTP 仅适用于可信内网;跨网络可通过 Tailscale 建立加密链路。不要将 MCP 工具端口直接映射到公网。

默认配置位置:

系统配置文件
macOS~/Library/Application Support/DSHComputerAgent/config.json
Windows%APPDATA%/DSHComputerAgent/config.json
Linux~/.config/DSHComputerAgent/config.json

配置保存设备名称、授权目录、命令开关和连接令牌。移走配置后重新启动会生成新令牌,需要重新配对。

可用参数:

参数用途
-config 指定独立配置文件
-listen 指定 MCP 监听地址与端口
-admin 指定本地配置页地址,必须使用本机回环地址
-log-dir 指定日志目录
-no-browser禁用自动打开配置页

在同一台电脑运行多个独立连接器时,应使用不同配置文件、连接令牌、MCP 端口和管理端口。