MCP server by BoussinesqJ
PRAXIS - 投研纪律系统
Practice, Reflection, And eXponential Improvement System 可验证、可审计、可复盘、可进化的个人投研纪律系统
🎯 系统定位
R1.0 定位：个人 A 股 / ETF / 场外基金组合的投研纪律系统（开源版本）
核心价值：
- 📊 投研闭环验证（策略是否跑赢基准）
- 🔒 纪律约束执行（风控规则不可绕过）
- 📝 决策全程记录（可复盘、可追溯）
- 🧬 策略持续进化（基于绩效数据，非事后叙事）
🚀 快速开始
安装
# 克隆仓库
git clone https://github.com/your-username/Praxis.git
cd Praxis
# 安装依赖
pip install -e .
配置 AI 工具
-
设置环境变量：
# Windows setx PRAXIS_WORKSPACE "你的实际路径\Portfolio vault" # Linux/Mac export PRAXIS_WORKSPACE="/你的实际路径/Portfolio vault" -
复制配置模板：
cp config/trae_config.example.json config/trae_config.json cp config/claude_desktop_config.example.json config/claude_desktop_config.json -
编辑配置文件，将
${PRAXIS_WORKSPACE}替换为你的实际路径
详细接入说明：docs/INTEGRATION_GUIDE.md
CLI 使用
praxis serve # 启动 MCP Server
praxis --help # 查看帮助
praxis portfolio get -i example -p demo # 读取组合
praxis market --tickers 600995,510310 # 获取行情
praxis performance -i example -p demo # 绩效指标
praxis validate # 验证配置
📊 系统能力
MCP 工具（63 个）
| 类别 | 工具数 | 说明 | |:----:|:------:|------| | Workspace 发现 | 1 | 零参数自动发现投资者/组合/状态 | | 查询工具 | 20 | 组合/行情/状态/绩效查询 | | 写入工具 | 8 | 交易/决策/进化（需审批） | | 投资者管理 | 3 | 创建投资者/组合/一键初始化 | | 审批流程 | 3 | 审批/拒绝/待审批列表 | | 数据清理 | 2 | 物理删除/按标签清空 | | 聚合概览 | 1 | 一次调用返回完整组合视图 | | 团队工具 | 5 | 三大团队 Prompt 管理 | | 模板工具 | 4 | 输出模板管理（需审批） | | 复盘工具 | 3 | 复盘自动回填/汇总/校准 | | 交易摩擦 | 4 | 费用/滑点/交易时间/确认日 | | 数据质量 | 3 | 行情质量检查/清洗/报告 | | Prompt版本 | 6 | 安全检查/版本管理/回滚/差异 |
MCP 资源（1 个）
| URI | 说明 |
|:---|:---|
| praxis://workspace/discovery | Workspace 元数据，连接握手时自动暴露 |
CLI 命令（17 个命令组）
praxis serve # 启动 MCP Server
praxis portfolio # 组合管理
praxis asset # 标的详情
praxis market # 行情数据
praxis reconcile # 对账计算
praxis constraints # 约束检查
praxis state # 状态查询
praxis ledger # 交易账本
praxis decision # 决策记录
praxis performance # 绩效指标
praxis strategy # 策略管理
praxis evolution # 进化引擎
praxis benchmark # 基准指数
praxis nav # 净值追踪
praxis ai-tracking # AI 建议命中率
praxis backtest # 策略回测
praxis validate # 配置验证
🏗️ 系统架构
┌─────────────────────────────────────────────────────────┐
│ 接入层 (Access Layer) │
│ MCP Server (Reasonix/Trae/Claude) + CLI (开发调试) │
│ + MCP Resource (praxis://workspace/discovery) │
├─────────────────────────────────────────────────────────┤
│ 决策层 (Decision Layer) │
│ Decision Record → 人工审批 → 执行 → 复盘 │
├─────────────────────────────────────────────────────────┤
│ 研究层 (Research Layer) │
│ AI 团队（ASRG / 大师圆桌 / 交易团队） │
├─────────────────────────────────────────────────────────┤
│ 规则层 (Rule Layer) │
│ 风控约束 · 交易纪律 · 策略参数（6 级分级） │
├─────────────────────────────────────────────────────────┤
│ 数据层 (Data Layer) │
│ 多源行情（AKShare/Baostock/东方财富/腾讯） │
│ 场外基金净值（AKShare/东方财富） │
├─────────────────────────────────────────────────────────┤
│ 事实层 (Fact Layer) │
│ 配置：YAML │ 账本：JSONL │ 状态：缓存 │ 审计：日志 │
└─────────────────────────────────────────────────────────┘
🤖 三大 AI 团队
| 团队 | 主理人 | 成员数 | 专业领域 | |:----:|:------:|:------:|---------| | ASRG | Gavin | 8 | 宏观策略→产业链→个股研究 | | 大师圆桌 | Arthur | 21 | 13 位投资大师 + 6 位分析师 | | 交易团队 | 协调器 | 12 | 多空辩论→网格优化→风险评估 |
📁 项目结构
Portfolio vault/
├── praxis/ # 源代码
│ ├── mcp_server.py # MCP Server 入口（63 工具 + 1 资源）
│ ├── cli.py # CLI 入口（17 个命令组）
│ ├── core/ # 核心模块（模型/接口/账本/日志）
│ ├── engine/ # 引擎层（对账/绩效/进化/回测/数据源）
│ │ └── data/ # 多源数据源（AKShare/Baostock/东方财富/腾讯）
│ └── tools/ # MCP 工具实现（含 workspace 发现）
├── data/ # 数据目录
│ ├── ledger/ # 交易账本（append-only）
│ ├── decisions/ # 决策记录
│ ├── audit/ # 审计日志
│ └── nav/ # 净值记录
├── investors/ # 投资者配置
├── strategies/ # 策略模板
├── teams/ # AI 团队配置
│ ├── base/ # 基础 Prompt（安全/角色/工具策略）
│ ├── base_prompts/ # 三大团队 Prompt
│ ├── investor/ # 投资者画像 Prompt
│ ├── strategy/ # 策略上下文
│ ├── adaptive/ # 自适应规则
│ └── output_templates/ # 输出模板
├── tests/ # 测试套件（418 个测试）
├── docs/ # 文档
├── config/ # 接入配置模板
├── providers/ # 数据源插件目录
└── README.md # 本文件
🧪 测试
python -m pytest tests/ -v # 运行所有测试
python -m pytest tests/test_workspace.py -v # 运行特定测试
测试结果：418 passed
📚 文档
| 文档 | 说明 | |------|------| | docs/API.md | API 文档 | | docs/DEPLOYMENT.md | 部署文档 | | docs/INTEGRATION_GUIDE.md | 接入指南 | | docs/ROADMAP.md | 开发路线图 |
🔧 接入指南
PRAXIS 支持 MCP 协议，可接入以下工具：
| 工具 | 配置文件 |
|------|---------|
| Reasonix | config/reasonix_config.example.toml |
| Trae | config/trae_config.example.json |
| Claude Desktop | config/claude_desktop_config.example.json |
| Cherry Studio | 同 Claude Desktop 配置 |
| OpenCode | config/opencode_config.example.json |
| Tare | config/tare_config.example.json |
详细接入说明：docs/INTEGRATION_GUIDE.md
🛡️ 安全机制
- ✅ 交易账本 append-only（不可覆盖）
- ✅ 幂等键防重复写入
- ✅ 原子写入保护
- ✅ Prompt 安全扫描（15 种危险模式）
- ✅ 规则系统 6 级分级
- ✅ 审计日志完整记录
- ✅ 推送前安全审查（强制）
- ✅ 路径遍历防护（validate_id + safe_path）
- ✅ 物理删除需 confirm 确认
📈 项目状态
| 指标 | 数值 | |:----:|:----:| | MCP 工具 | 63 | | MCP 资源 | 1 | | CLI 命令组 | 17 | | 测试用例 | 418 | | 数据源 | 4（AKShare/Baostock/东方财富/腾讯）+ 用户插件 | | AI 团队 | 3 | | 输出模板 | 5 | | 版本 | r1.0.0 |
📋 开发路线图见 docs/ROADMAP.md
📄 许可证
MIT License - 详见 LICENSE 文件