DeepSeek Harness 配置

August 21, 2026 · View on GitHub

English configuration

Little Mouse Pointer 通过 MCP stdio bridge 接入 DeepSeek Harness。下面的配置直接启动发行包中的 self-contained exe，并通过本机 loopback HTTP endpoint 与桌面程序通信。MCP stdio 不应通过 run.ps1 转发，因为 PowerShell 脚本层不能可靠保持标准 MCP 客户端的双向 stdin 流。

如果 Harness 支持仓库根目录的 DSH bundle，推荐直接执行上层 安装检查表 中的 GitHub 安装命令；本页配置用于手工接入或不支持 bundle 的 Harness 版本。

cordis.yml

将下面的插件项加入 Harness 的 cordis.yml、preset 或对应的 Cordis 配置层，把 C:/path/to/little-mouse-pointer 替换为实际插件根目录。YAML 中建议使用正斜杠，避免反斜杠转义问题。

- id: mcp-little-mouse-pointer
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: little-mouse-pointer
    transport: stdio
    command: 'C:/path/to/little-mouse-pointer/app/MousePointer.Windows.exe'
    args:
      - --mcp-stdio
      - --endpoint
      - 'http://127.0.0.1:49153/'
    cwd: 'C:/path/to/little-mouse-pointer'
    env:
      MOUSE_POINTER_HTTP_PORT: '49153'

对于 GitHub 仓库检出，插件根目录是 Auto_Mouse/plugins/little-mouse-pointer；对于独立发行版 zip，插件根目录是解压后的 little-mouse-pointer 目录。不同 Harness 版本可能把 MCP client 配置放在 preset 或其他 Cordis 配置层；保留上面的字段含义，并按照该版本的 MCP client 配置入口放置即可。@deepseek-ai/dsh-mcp-client 必须已经安装在 Harness 工作区中。

工具

客户端注册后提供以下工具：

mcp__little-mouse-pointer__ui_context_pick
mcp__little-mouse-pointer__ui_context_current
mcp__little-mouse-pointer__ui_context_clear

ui_context_pick 会打开或恢复控制小窗，并等待用户完成选取、预览和确认。ui_context_current 读取最近一次已经确认的结果。ui_context_clear 清除最近一次结果引用。工具不会自动点击、输入、发送消息或操作原应用。

端口

默认端口为 49153，只监听 127.0.0.1。如果端口已占用，必须同时修改 --endpoint 的端口和 MOUSE_POINTER_HTTP_PORT 的值。端口配置不一致会导致 bridge 找不到桌面程序。

排查

  • 确认 cwd 指向完整插件根目录，command 直接指向该目录下的 app/MousePointer.Windows.exe。
  • 确认该目录直接包含 .codex-plugin\plugin.json、.mcp.json、app 和 run.ps1。
  • command 必须指向 app/MousePointer.Windows.exe，不要把 run.ps1 配成 stdio bridge。
  • run.ps1 只用于手动启动 GUI 或 self-test，不用于 Harness 的 MCP stdio 子进程。
  • 关闭旧的 MousePointer.Windows.exe 实例后再重试，避免多个全局鼠标钩子竞争。
  • 不要把日志或诊断文本写入 MCP stdout；run.ps1 已将启动诊断写到 stderr。
  • 工具返回输出目录时，始终使用返回结果中的权威路径读取 JSON、Markdown 和截图，不要猜测路径。