# 1. 环境（必须 --system-site-packages，否则拿不到被包装项目已有的 pandas）
python -m venv --system-site-packages .venv
./.venv/Scripts/python.exe -m pip install -r requirements.txt   # Linux/macOS: .venv/bin/python

# 2. 配置被包装项目的位置（见下节；同级目录可省略）

# 3. 协议层冒烟测试（不是 import 调函数，是真实 stdio 握手）
./.venv/Scripts/python.exe tests/smoke_test.py

工作区/
├── mcp-portfolio/     ← 本仓库
├── quant/agentskill/  ← QUANT_ETF_HOME
└── astock-agent/      ← ASTOCK_AGENT_HOME

{
  "mcpServers": {
    "quant-core": {
      "command": "<本仓库绝对路径>/.venv/Scripts/python.exe",
      "args": ["<本仓库绝对路径>/servers/quant_core.py"],
      "env": { "QUANT_ETF_HOME": "<量化框架绝对路径>" }
    },
    "quant-portfolio": {
      "command": "<本仓库绝对路径>/.venv/Scripts/python.exe",
      "args": ["<本仓库绝对路径>/servers/quant_portfolio.py"],
      "env": { "QUANT_DB": "<trading.db 绝对路径>" }
    },
    "astock-agent": {
      "command": "<本仓库绝对路径>/.venv/Scripts/python.exe",
      "args": ["<本仓库绝对路径>/servers/astock_agent.py"],
      "env": {
        "ASTOCK_BASE_URL": "http://127.0.0.1:8080",
        "ASTOCK_TOKEN": ""
      }
    }
  }
}

sqlite3.connect(f"file:{db_path}?mode=ro", uri=True)

mcp-portfolio/
├── servers/
│   ├── _common.py           # 路径注入 / JSON 清洗 / 错误结构
│   ├── quant_core.py        # 量化框架封装
│   ├── quant_portfolio.py   # 实盘账户只读查询
│   └── astock_agent.py      # Java 投研 Agent 网关
├── tests/
│   ├── smoke_test.py        # 协议层冒烟测试
│   └── smoke_report.json    # 最近一次结果
└── README.md