┌─────────────────────────────────────────────────────────────┐
│                      Frontend (React)                        │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐        │
│  │ 情绪仪表 │ │ 大单监控 │ │ 热门市场 │ │ 聪明钱   │        │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘        │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    HTTP API (Flask)                          │
│  /stats  /hot  /smart-money  /trades  /sentiment  /arbitrage│
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    MCP Tools Layer                           │
│  ┌────────────┐ ┌────────────┐ ┌────────────┐               │
│  │ Profiler   │ │ Advisor    │ │ Analyzer   │               │
│  │ 交易者画像 │ │ 交易建议   │ │ 套利检测   │               │
│  └────────────┘ └────────────┘ └────────────┘               │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    Data Layer                                │
│  ┌────────────┐ ┌────────────┐ ┌────────────┐               │
│  │ Indexer    │ │ Decoder    │ │ SQLite DB  │               │
│  │ 区块链索引 │ │ 交易解码   │ │ 数据存储   │               │
│  └────────────┘ └────────────┘ └────────────┘               │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│              External Data Sources                           │
│  ┌────────────────────┐  ┌────────────────────┐             │
│  │ Polygon RPC        │  │ Gamma API          │             │
│  │ CTF Exchange Events│  │ Market Metadata    │             │
│  └────────────────────┘  └────────────────────┘             │
└─────────────────────────────────────────────────────────────┘

# 1. 克隆项目
git clone https://github.com/your-repo/polymind-mcp.git
cd polymind-mcp

# 2. 创建虚拟环境
python -m venv venv
.\venv\Scripts\activate  # Windows
# source venv/bin/activate  # macOS/Linux

# 3. 安装依赖
pip install -r requirements.txt

# 4. 配置环境变量
cp .env.example .env
# 编辑 .env，填入 RPC_URL

# 🚀 一键演示模式（推荐评审使用）
python start.py demo

# 📊 验证数据
python verify_data.py

# 🌐 只启动 API 服务
python start.py api

# 🔗 索引链上数据（需要 RPC_URL）
python start.py index --from-block 66000000 --to-block 66001000

# 📦 同步市场元数据
python start.py sync-markets

cd frontend
python -m http.server 3000

PolyMind-MCP/
├── src/
│   ├── mcp/                   # MCP 服务模块
│   │   ├── server.py          # HTTP API 服务
│   │   ├── mcp_server.py      # MCP stdio 服务
│   │   ├── tools.py           # MCP 工具实现
│   │   ├── profiler.py        # 交易者画像
│   │   └── advisor.py         # 交易建议引擎
│   ├── indexer/               # 区块链索引器
│   │   ├── run.py             # 索引器主逻辑
│   │   ├── store.py           # 数据存储
│   │   └── gamma.py           # Gamma API 客户端
│   ├── db/                    # 数据库模块
│   │   └── schema.py          # 表结构定义
│   ├── trade_decoder.py       # 交易解码器
│   └── market_decoder.py      # 市场参数解码器
├── frontend/                  # Web 前端
│   ├── index.html             # 主页面
│   ├── script.js              # React 组件
│   └── styles.css             # 样式
├── data/                      # 数据目录
│   └── polymarket.db          # SQLite 数据库
├── tests/                     # 测试
├── docs/                      # 文档
├── start.py                   # 统一启动脚本
├── verify_data.py             # 数据验证脚本
├── requirements.txt           # Python 依赖
├── .env.example               # 环境变量示例
├── README.md                  # 项目说明
└── DEMO.md                    # 演示说明

{
  "mcpServers": {
    "polymind": {
      "command": "python",
      "args": ["-m", "src.mcp.mcp_server"],
      "cwd": "/path/to/polymind-mcp",
      "env": {
        "RPC_URL": "your-polygon-rpc-url"
      }
    }
  }
}

# 运行所有测试
pytest tests/

# 运行特定测试
pytest tests/test_market_decoder.py -v

# 验证系统
python verify_system.py

# 格式化代码
black src/

# 类型检查
mypy src/