safe-agent-mcp

DeepSeek Harness 기반의 안전한 다중 에이전트 MCP 게이트웨이: DSH의 에이전트 실행 기능을 표준 MCP 도구로 캡슐화하여 모든 MCP 클라이언트(Claude Desktop, Cursor 등)가 호출할 수 있게 합니다.

이 프로젝트가 해결하는 것

• DSH는 다중 에이전트 프레임워크이지만, 기능은 자체 인터페이스에서만 사용할 수 있습니다;

• MCP는 표준 프로토콜로, 모든 클라이언트가 연결할 수 있지만 자체적으로 에이전트 기능은 없습니다;

• safe-agent-mcp는 두 가지를 연결하는 다리입니다: MCP 서버로서 외부에는 표준 도구를 제공하고, 내부적으로는 DSH의 에이전트(하위 에이전트, 샌드박스 포함)를 구동합니다.

Related MCP server: py-sandbox

특징

빠른 시작

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

현재 구현된 도구:

• run_command: 샌드박스에서 셸 명령을 실행하고 stdout / stderr / 종료 코드를 반환합니다(Windows에서는 cmd의 GBK 인코딩 문제를 처리했습니다).

디렉터리 구조

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

마일스톤

• v1.0: MCP 서버 + run_command 도구(스모크 테스트 모두 통과)

• v1.1: run_agent_task 다중 에이전트 연동(headless 브리지)

• v1.2: 보안 셸(위험 명령 차단 + 키 마스킹 + 감사 로그)

• v1.3: 웹 대시보드(보너스 항목)

자세한 내용은 docs/DEVELOPMENT.md를 참조하세요.

라이선스

MIT