Poly Mind MCP

PolyMind MCP

🧠 AI 驱动的 Polymarket 预测市场分析平台

  

项目简介

PolyMind MCP 是一个基于 Polygon 链上真实数据构建的 Polymarket 生态数据分析平台。通过解码链上 OrderFilled 事件，提供聪明钱追踪、市场情绪分析、套利机会检测等功能，帮助交易者做出更明智的决策。

核心价值：

• 🔗 链上数据驱动 - 直接从 Polygon 链获取并解码真实交易数据
• 🧠 聪明钱分析 - 识别高胜率交易者，追踪其持仓变化
• 📊 可视化看板 - 实时展示市场情绪、大单监控、热门市场
• 🤖 MCP 协议 - 支持 Claude Desktop 集成，自然语言查询

技术架构

┌─────────────────────────────────────────────────────────────┐
│                      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    │             │
│  └────────────────────┘  └────────────────────┘             │
└─────────────────────────────────────────────────────────────┘

技术栈：

• 后端: Python 3.9+, Flask, SQLite
• 前端: React (CDN), Tailwind CSS
• 链上交互: Web3.py, Polygon RPC
• 协议: MCP (Model Context Protocol)

快速开始

环境要求

• Python 3.9+
• 有效的 Polygon RPC URL（推荐 Alchemy/Infura）

安装步骤

# 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

功能说明

核心功能

MCP 工具列表

HTTP API 端点

数据查询

分析功能

AI 功能

数据来源

本项目使用以下数据源：

合约地址

示例数据

• 交易哈希: 0x916cad96dd5c219997638133512fd17fe7c1ce72b830157e4fd5323cf4f19946
• 市场 Slug: will-there-be-another-us-government-shutdown-by-january-31

可在 Polygonscan 验证: https://polygonscan.com/tx/0x916cad96dd5c219997638133512fd17fe7c1ce72b830157e4fd5323cf4f19946

项目结构

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                    # 演示说明

环境变量

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

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

配置完成后，可在 Claude Desktop 中直接查询：

• "显示最热门的 10 个预测市场"
• "分析地址 0x1234... 的交易行为"
• "查找当前的套利机会"

开发

运行测试

# 运行所有测试
pytest tests/

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

# 验证系统
python verify_system.py

代码风格

# 格式化代码
black src/

# 类型检查
mypy src/

激励机制设计

防止作恶

1. 链上数据不可篡改 - 所有交易数据直接从 Polygon 链获取并验证
2. 透明的聪明钱算法 - 胜率计算基于链上可验证的交易历史
3. 开源可审计 - 所有代码开源，任何人可以验证数据处理逻辑

激励正确预测

1. 聪明钱排行榜 - 高胜率交易者获得曝光，建立链上信誉
2. 跟单信号 - 用户可追踪表现优秀的交易者
3. 套利提醒 - 及时发现市场定价偏差，奖励信息发现者

团队成员

• 开发者: AN_SU,Ethan,Rustc.rs,bluerabbit2026

License

MIT License - 详见 LICENSE 文件