内容
# QuantGuard MCP
QuantGuard MCP 是一款基于 **NitroStack** 框架（TypeScript、NestJS 风格的依赖注入、`@Tool` / `@Resource` / `@Prompt` 装饰器、Zod 验证和 React 可视化小部件）构建的模型上下文协议（MCP）服务器。
它旨在为机构交易台提供服务，持续监控市场微观结构，并评估多个专业代理的交易安全性，生成以自然语言解释的确定性风险决策。
> ### 📐 [低级设计文档（LLD）→](./LLD.md)
> 完整的架构图、数据库 ERD、代理编排流程、工具/资源 API 合同、提示模板和 UI 小部件规格。
## 🚀 主要功能
1. **持续微观结构监控**： feeds on orderbook depth and price streams（与加密的实时 Binance WebSocket 集成）。
2. **确定性风险和执行规则**：
- **毒性（VPIN）**：计算有符号交易量桶中的不平衡。
- **虚假申报检测**：检测快速取消的大型静止订单以操纵价格方向的启发式方法。
- **流动性概况**：在平方根市场影响模型下估计滑移。
3. **机构风险引擎**：计算风险价值（VaR 95%）、预期短缺（CVaR）、暴露限制和杠杆阈值。
4. **关键词情感词典**：在没有 LLM 延迟的情况下评估突发新闻和宏观经济日历。
5. **多代理编排**：在 7 个专业代理之间协调报告：
- *毒性代理、虚假申报代理、流动性代理、波动性代理、风险代理、新闻代理和策略代理。*
6. **精致的交互式小部件**：在 NitroStudio 中本地加载的时尚暗模式 React 仪表板。
## 🛠️ 安装和设置
1. **克隆和安装依赖项**：
```bash
npm install
```
2. **配置环境变量**：
在根目录中创建一个 `.env` 文件：
```env
# 服务器配置
NODE_ENV=development
PORT=3000
# 演示模式切换
DEMO_MODE=true
# 可选的 LLM 密钥（如果省略，将使用高质量的本地模板）
GEMINI_API_KEY=your_gemini_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
```
3. **构建服务器和部件**：
```bash
npm run build
```
## 🏁 直播演示模拟
QuantGuard 配备了一个内置的终端仪表板模拟器。它在 `DEMO_MODE=true` 下启动 MCP 服务器，订阅实时 Binance 消息流，并安排一个综合的虚假申报攻击时间表，以演示服务器的保护逻辑：
- **0s - 120s**：正常市场条件。推荐策略：`VWAP` 或 `MARKET`。
- **120s - 180s**：注入虚假申报墙。推荐策略：立即切换到 `WAIT`。
- **180s+**：虚假申报墙取消。推荐策略：恢复到 `VWAP`。
要启动交互式演示：
```bash
node demo.js
```
## 🔌 连接到客户端 / NitroStudio
- **STDIO 连接**：添加到您的 MCP 客户端配置（例如，Claude Desktop）：
```json
{
"mcpServers": {
"quantguard": {
"command": "node",
"args": ["C:/Users/Siddharth/.gemini/antigravity/scratch/quantguard-mcp/dist/index.js"],
"env": {
"DEMO_MODE": "true"
}
}
}
}
```
- **可流式 HTTP 端点**：通过 `http://localhost:3000/mcp` 连接
- **Visual Studio**：在本地启动 **NitroStudio**，并将其指向项目目录以检查 `quantguard-dashboard` 小部件。
## ☁️ 云部署（NitroCloud）
使用官方的 NitroStack CLI 实用程序将您的 MCP 服务器部署到 NitroCloud：
```bash
npx nitrostack-cli deploy --cloud
```
这会捆绑生产资产，优化 SQLite 迁移，注册工具元数据，并将其部署到无服务器边缘端点。
