deepseek-harness
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
DeepSeek Harness & WorkBuddy for Codex
DeepSeek Harness & WorkBuddy for Codex 将 Codex 打造成本地桌面双 Agent 协同与验收中枢。通过标准 MCP(Model Context Protocol)与本地原生通信通道,Codex 能够同时操控并监督 DeepSeek Harness 与 WorkBuddy 两个桌面级执行器:由 Codex 负责需求拆解、精简派工与独立验收,两套 Agent 各展所长、在各自的原生会话与环境中执行交付。
┌──────────────────────────────────────────────┐
│ Codex (CLI / Desktop) │
│ 总指挥 & 独立验收官 (Supervisor & Reviewer) │
└──────────────┬────────────────┬──────────────┘
│ │
MCP: deepseek-harness│ │ MCP: workbuddy
│ │
▼ ▼
┌──────────────────┐ ┌──────────────────┐
│ DeepSeek Harness │ │ WorkBuddy Gateway│
│ (Desktop Host) │ │ (desktop-queue) │
└─────────┬────────┘ └────────┬─────────┘
│ (Loopback RPC) │ (CDP / Channel RPC)
▼ ▼
┌──────────────────┐ ┌──────────────────┐
│ DeepSeek 真实会话 │ │ WorkBuddy 真实会话 │
│ 深度工程/重构/逆向 │ │ 业务文档/办公自动化│
└──────────────────┘ └──────────────────┘核心特性与分工优势
角色 | 定位与适用场景 | 关键机制 |
Codex (中枢) | 任务调度、流水线编排、差分复核与最终交付验收。不代写执行代码,通过真实产物与测试证据客观核验。 | MCP 客户端、多 Agent 上下文汇聚、返工管理 (Rework) |
DeepSeek Harness | 深度系统架构设计、算法实现、代码重构、Shell 交互与逆向工程。在原生桌面或 Web 会话中高效运行。 | 官方 Host 插件伴随通信、增量事件流同步、同会话持续监督与接管 |
WorkBuddy | 业务数据整理、文档/表格自动化、企业微信生态集成及办公工作流。 | CDP 原生唤醒、无感目录会话绑定 ( |
Related MCP server: Codex to OpenCode MCP Server
快速开始
1. 准备环境
macOS 系统
Node.js 22 或更高版本(推荐 Node 22+ LTS)
支持插件与 MCP 的 Codex 客户端(桌面版或
codexCLI)已安装并已登录的桌面应用:
2. 接入 DeepSeek Harness
方式 A:安装 Codex 插件(推荐)
在终端中执行以下命令添加插件:
codex plugin marketplace add Seann0824/deepseek-harness-for-codex --ref main
codex plugin add deepseek-harness@deepseek-harness-for-codexmacOS 备用路径:若全局 codex 被覆盖,可使用 /Applications/ChatGPT.app/Contents/Resources/codex。
方式 B:本地源码或独立 MCP
在本项目根目录构建后注册本地 MCP:
npm install
npm run check
codex mcp add deepseek-harness -- /path/to/dist/bin.mjs3. 接入 WorkBuddy 网关
WorkBuddy 支持基于项目目录自动初始化与唤醒原生执行会话:
构建 WorkBuddy 网关:
cd codex-workbuddy-gateway npm install npm run build配置环境变量 (
.env):WORKBUDDY_BACKEND=desktop-queue WORKBUDDY_NODE_BIN=/Users/你的用户名/.nvm/versions/node/v22.xx.x/bin/node一键注册与 Skill 安装: 直接运行一键配置脚本:
./codex-workbuddy-gateway/setup-for-codex.sh该脚本会自动将
workbuddyMCP 注入~/.codex/config.toml,并将workbuddy-executorSkill 部署到~/.codex/skills/。
4. 验证接入状态
在终端运行以下命令,确认两端 MCP 服务均处于 enabled 状态:
codex mcp list输出应包含:
deepseek-harness:已启用(控制 DeepSeek Harness)workbuddy:已启用(控制 WorkBuddy)
双 Agent 协同使用示例
在 Codex 中启动一个新对话,使用以下模板让 Codex 同时调度两个 Agent:
你现在同时具备操控 DeepSeek Harness 和 WorkBuddy 两个执行器的能力。
请帮我推进项目 /Users/username/my-project:
1. 调用 workbuddy_ensure_workspace 初始化 WorkBuddy 该项目的绑定会话;
2. 将底层的核心逻辑重构与测试编写派工给 DeepSeek Harness 执行;
3. 将项目 API 接口说明文档和测试清单梳理派工给 WorkBuddy 执行;
4. 你作为总指挥负责跟进两边的执行进度;
5. 在两边执行完成后,独立审查代码 diff 与产物文件,确认无误后完成最终验收。MCP 工具参考
1. DeepSeek Harness 工具组 (deepseek-harness)
工具 | 用途 |
| 向现有的 Harness 桌面原生会话派发任务,建立持久跟踪的轮次。 |
| 轮询等待桌面端输出,单次最多 30 秒,按轮次返回增量结果。 |
| 审查不合格时,向同一会话追加修改意见,进行同会话返工 (Rework)。 |
| 将用户在 Harness 桌面 UI 手动启动的轮次纳入 Codex 的监督状态机中。 |
| 读取本地已有的桌面会话历史与工作区绑定。 |
| 安全读取特定会话历史记录(冷读取,不激活模型)。 |
| 管理由 MCP 自动拉起的 Harness Web 回环服务及临时会话。 |
| 检查本地 Harness 运行环境、Node、权限模式与数据目录。 |
2. WorkBuddy 工具组 (workbuddy)
工具 | 用途 |
| 根据目标绝对目录原生创建、绑定或复用 WorkBuddy 真实会话。 |
| 将任务放入本地持久队列,由后台服务通过 CDP 唤醒桌面执行。 |
| 等待并读取 WorkBuddy 执行进度与当前轮次成果上报。 |
| 保持相同会话与历史上下文,向 WorkBuddy 发送返工要求。 |
| 经 Codex 独立核对真实产物后,记录最终验收凭证。 |
| 查询 WorkBuddy 当前可用模型列表与各项目工作区绑定状态。 |
| 探测 WorkBuddy 桌面端连通性与监听器状态。 |
安全与隔离机制 (Hardening)
严格的本地回环 RPC:所有跨进程通信均限制在
127.0.0.1本地回环网络或受保护的本地 Unix Domain Socket(0700/0600权限),不开放公网端口。沙箱与目录白名单:默认启用
workspace-write保护策略,支持通过DSH_MCP_WORKSPACE_ROOTS严格限制只允许访问的项目根目录,拒绝目录穿越。敏感操作非越权:
当 DeepSeek Harness 触发文件写保护、高危命令审批(Approval)或调用
ask_user_question咨询时,桥接器如实上报waiting_input,绝不自动代用户越权同意,必须由用户在桌面端 GUI 界面确认。WorkBuddy 的原生权限与首次登录状态同样由用户在原生客户端授权。
独立验收与防伪保证:
执行器报告“完成”不等于任务合格。平台与 Codex 保持严格的“内容验收与格式完成分离”契约,所有完成态必须经过外部 Codex 的实际文件 diff 比对或测试命令核验。
本地开发与测试
# 根项目(DeepSeek Harness 桥接器)
npm install
npm run check # 包含 TypeScript 类型检查、Vitest 测试与 Tsdown 构建
npm test # 运行测试用例
# WorkBuddy 网关子模块
cd codex-workbuddy-gateway
npm install
npm test # 运行 160+ 项全套自动化集成测试
npm run build开源协议
本项目基于 MIT 协议 开源。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Coding agents build full-stack apps in persistent workspaces and share them by link.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Persistent cloud workspaces for AI agents: run commands, edit files, use git and a browser.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Codex to start the local DeepSeek Harness Web UI, delegate coding tasks into visible sessions, and review workspace changes.129 npm15MIT
- AlicenseAqualityDmaintenanceEnables Codex to delegate coding tasks to an OpenCode CLI locally, returning structured results such as exit codes, session summaries, tool calls, and git diffs.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT conversations to directly inspect local workspaces and delegate coding tasks to a local Codex agent, with controlled concurrency, reusable sessions, and task/usage tracking.MIT
- AlicenseNot gradedqualityBmaintenanceEnables Antigravity to delegate concrete local coding tasks to Codex CLI with durable sessions, background execution, native chat links, and event-driven receipts.MIT