# safe-agent-mcp

基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的安全多 Agent MCP 网关：把 DSH 的 agent 执行能力封装成标准 [MCP](https://modelcontextprotocol.io) 工具，让任何 MCP 客户端（Claude Desktop、Cursor 等）都能调用。

## 这个项目解决什么

- **DSH** 是多 Agent 框架，但能力只能在自己的界面里用；
- **MCP** 是标准协议，任何客户端都能接，但本身没有 agent 能力；
- **safe-agent-mcp** 是两者的桥：一个 MCP 服务器，对外提供标准工具，对内驱动 DSH 的 agent（含子 Agent、沙箱）。

## 特性

| 关键词 | 实现 |
|---|---|
| MCP | 标准 MCP 服务器（`@modelcontextprotocol/sdk`），任何 MCP 客户端即插即用 |
| 多 Agent | （规划中 v1.1）通过 `dsh --profile headless` 驱动 DSH 子 Agent 执行任务 |
| 沙箱/安全 | （规划中 v1.2）危险命令拦截、密钥脱敏、审计日志、超时与并发限制 |

## 快速开始

```bash
npm install
npm run smoke     # 自动化冒烟测试（协议握手 + 工具调用）
npm run inspect   # 打开 MCP Inspector 可视化调试
```

当前已实现工具：

- `run_command`：在沙箱中执行一条 shell 命令，返回 stdout / stderr / 退出码（Windows 下已处理 cmd 的 GBK 编码问题）。

## 目录结构

```
src/index.ts        # MCP 服务器入口
tests/smoke.mjs     # 冒烟测试
docs/DEVELOPMENT.md # 开发文档（架构、里程碑、开发日志）
```

## 里程碑

- [x] v1.0：MCP 服务器 + `run_command` 工具（冒烟测试全绿）
- [ ] v1.1：`run_agent_task` 多 Agent 接入（headless 桥接）
- [ ] v1.2：安全壳（危险命令拦截 + 密钥脱敏 + 审计日志）
- [ ] v1.3：Web 仪表盘（加分项）

详见 [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)。

## License

[MIT](LICENSE)