# DeepSeek MCP Server & Agent Harness

Hệ thống MCP Server tích hợp DeepSeek-Flash (V4.1) với Native Agent Harness, hỗ trợ Thinking Mode (CoT) linh hoạt, TDD test runner tự động và cơ chế phản biện gắt Doubt-Driven Development.

## Vị trí cài đặt
- **Mã nguồn Server:** `~/.local/share/deepseek-mcp/server.py`
- **Môi trường ảo (venv):** `~/.local/share/deepseek-mcp/venv/`
- **Cấu hình API Key:** `~/.local/share/deepseek-mcp/.env`
- **Cấu hình Antigravity MCP:** `~/.gemini/config/mcp_config.json`

## Danh sách công cụ (MCP Tools)

### 1. `deepseek_ask`
Truy vấn trực tiếp DeepSeek-Flash:
- `prompt` (string, required): Câu hỏi hoặc yêu cầu.
- `thinking` (bool, default `True`): Bật/tắt suy luận CoT.
- `effort` (string: `'low'`, `'high'`, `'max'`, default `'high'`): Mức độ suy luận.
- `system_prompt` (string, optional): Chỉ dẫn hệ thống tĩnh để tối ưu KV Cache.

### 2. `deepseek_code_task`
Agent Harness tự chủ thực hiện chu trình: **Lập Spec (Architect CoT)** -> **Sửa file & chạy test (Coder ReAct)** -> **Tự phản biện (Doubt Gate)**:
- `workspace_dir` (string, required): Đường dẫn tuyệt đối thư mục dự án.
- `task` (string, required): Mô tả bài toán cần làm.
- `test_cmd` (string, optional): Lệnh chạy test tự động (ví dụ: `pytest tests/test_perf.py`).
- `thinking` (bool, default `True`): Dùng thinking mode cho Architect và Reviewer.
- `effort` (string, default `'high'`): Mức độ suy luận CoT.
- `run_adversarial_review` (bool, default `True`): Tự động thẩm định git diff sau khi test xanh.
- `max_turns` (int, default `12`): Số lượt ReAct tối đa.

### 3. `deepseek_adversarial_review`
Persona phản biện độc lập (Doubt-Driven) mang tâm thế "bác bỏ, tìm cách phá hỏng code":
- `code_or_diff` (string, required): Đoạn code hoặc git diff cần audit.
- `context_spec` (string, optional): Tài liệu yêu cầu / hợp đồng chức năng.
- `effort` (string: `'high'` hoặc `'max'`, default `'high'`).

### 4. `deepseek_health`
Kiểm tra tình trạng kết nối tới DeepSeek API, đo latency và kiểm tra token.

## Chốt chặn an toàn (Guardrails)
1. **Workspace Boundary:** Chặn path traversal ra ngoài `workspace_dir`.
2. **Command Blacklist:** Chặn các lệnh nguy hiểm (`rm -rf /`, `rm -rf *`, `mkfs`, `dd`, `git push --force`...).
3. **Git Safety Net:** Tự động tạo branch tạm `deepseek/task-<timestamp>` trước khi sửa mã nguồn.

## Kiểm thử
Chạy toàn bộ 11 bài unit & live integration tests:
```bash
~/.local/share/deepseek-mcp/venv/bin/pytest ~/.local/share/deepseek-mcp/tests/ -v
```