使用说明
Polymarket MCP
您在预测市场中的人工智能优势。 搜索、分析、检测错误定价、追踪鲸鱼和纸张交易——所有这些都来自你的法学硕士。
这是什么
大多数预测市场工具都会给你一个仪表板。这给了你一个 大脑Polymarket MCP将任何LLM(Claude、GPT、Gemini)连接到Polymarket的数据,并用EV计算、Kelly尺寸、套利检测、鲸鱼跟踪、纸质交易和加密相关性分析对其进行包装——所有这些都是您的AI可以自主调用的MCP工具。
不是玩具。不是包装纸。用于预测市场的完整代理工具包。
特性
| 类别 | 工具 | 您将获得什么 |
|---|---|---|
| 市场数据 | 5 | 搜索、趋势、详细信息、体育和加密市场过滤器 |
| 风险和规模 | 3 | 期望值计算、Kelly准则、套利扫描 |
| 研究与边缘 | 3 | 新闻情绪分析、批量边缘查找、自动边缘扫描 |
| 模拟交易 | 5 | 无风险实践、投资组合跟踪、结算、交易历史、订单簿 |
| 加密 | 4 | 实时价格(CoinGecko)、恐惧与贪婪指数、加密货币与预测交叉分析 |
| 鲸鱼追踪 | 1 | 监控顶级Polymarket钱包和大额头寸变化 |
| 自治代理 | -- | 独立代理模式:扫描11000多个市场,具有风险控制的纸质交易 |
快速开始
git clone https://github.com/Miles0sage/polymarket-mcp.git
cd polymarket-mcp
pip install -r requirements.txt
添加到MCP配置(~/.mcp.json 或客户端设置):
{
"mcpServers": {
"polymarket": {
"command": "python3",
"args": ["server.py"],
"cwd": "/path/to/polymarket-mcp"
}
}
}
市场数据不需要API密钥。可立即与Claude Code、Cursor、Windsurf或任何MCP客户端配合使用。
工具参考
市场数据(5个工具)
| 工具 | 说明 |
|---|---|
search_markets |
按关键字搜索活跃市场 |
get_market |
特定市场的完整细节(价格、交易量、流动性、日期) |
trending_markets |
按交易量排名的顶级市场 |
crypto_prediction_markets |
活跃的加密货币相关市场(BTC、ETH、SOL、DeFi) |
sports_prediction_markets |
活跃的体育市场(NBA、NFL、UFC、F1、NCAA) |
风险和规模(3个工具)
| 工具 | 说明 |
|---|---|
calculate_ev |
是/否位置的预期值+凯利尺寸 |
kelly_size |
根据资金、概率和赔率,确定凯利的全部和四分之一投注规模 |
arbitrage_scan |
检测市场结果中的套利行为 |
研究和边缘发现(3个工具)
| 工具 | 说明 |
|---|---|
research_market |
新闻+YouTube+任何市场问题的情绪分析 |
edge_finder |
通过新闻情绪与市场价格对市场进行批量扫描,找出错误定价 |
scan_edges |
自动扫描趋势市场,寻找高于您阈值的边缘 |
纸品交易(5种工具)
| 工具 | 说明 |
|---|---|
paper_trade |
使用虚拟资金进行模拟交易 |
paper_portfolio |
查看未结头寸和损益 |
paper_settle |
当市场稳定时结算交易 |
paper_history |
完整的交易历史记录及结果 |
get_orderbook |
市场代币的实时订单深度 |
鲸鱼追踪(1个工具)
| 工具 | 说明 |
|---|---|
whale_activity |
监控Polymarket顶级交易员和大额头寸变动 |
加密货币(4工具)
| 工具 | 说明 |
|---|---|
crypto_prices |
CoinGecko的实时价格,包括24小时变化、交易量和市值 |
crypto_overview |
市值排名前20位的加密货币 |
crypto_fear_greed |
比特币恐惧与贪婪指数(7天历史+交易信号) |
crypto_vs_predictions |
将现货价格与相关Polymarket市场进行比较 |
用法示例
"Search Polymarket for Bitcoin markets"
-> 10 markets with YES/NO prices, volume, liquidity
"Calculate EV: YES price 0.35, my estimate 0.55"
-> EV: +57.1%, Quarter-Kelly: 7.7% of bankroll, BET YES
"Check for arbitrage: 0.45, 0.43, 0.08"
-> ARBITRAGE FOUND! Buy all for $0.96, collect $1.00
"Paper trade $50 YES on 'Will BTC hit 200K?'"
-> Trade placed, virtual bankroll updated, tracking P&L
"Scan for edges with min 5% mispricing"
-> 3 markets found with news sentiment diverging from price
"Show whale activity"
-> Top traders, recent large positions, copy signals
"What's the Fear & Greed Index saying?"
-> 7-day chart, current reading, trading signal
建筑
+------------------+
| LLM / Client |
| (Claude, GPT...) |
+--------+---------+
|
MCP Protocol
|
+--------v---------+
| MCP Server |
| (server.py) |
+--------+---------+
|
+------------+----------+----------+------------+
| | | | |
+----v----+ +-----v----+ +--v------+ +-v--------+ +-v--------+
| Markets | | Analysis | | Research| | Trading | | Crypto |
+---------+ +----------+ +---------+ +----------+ +----------+
| | | | |
Gamma API EV/Kelly Google Paper P&L CoinGecko
CLOB API Arbitrage News Orderbook Fear/Greed
YouTube Whales
独立代理
除了MCP工具之外, agent.py 作为一个完全自主的交易代理运行:
- 扫描11000多个活跃市场的错误定价
- 对纸质交易进行风险控制(头寸限制、资金管理)
- 通过Telegram发送关于高端机会的警报
- 在cron上运行或作为长期进程运行
python3 agent.py
Web仪表板(彭博风格UI):
python3 dashboard.py # port 8501
比较
| 功能 | Polymarket MCP | Polystrat | Kalshi新闻机器人 | 手动交易 |
|---|---|---|---|---|
| LLM集成 | 本机MCP | 无 | 仅限API | 无 |
| 边缘检测 | 自动(新闻) | 手动 | 无 | 手动 |
| Kelly尺寸 | 内置 | 无 | 无 | 电子表格 |
| 套利扫描 | 内置 | 无 | 无 | 手动 |
| 纸上交易 | 内置 | 无 | 无 | 不适用 |
| 鲸鱼追踪 | 内置 | 无 | 无 | 手动 |
| 加密相关 | 实时 | 无 | 不适用 | 手动 |
| 开源 | 麻省理工学院 | 关闭 | 关闭 | 不适用 |
| 安装时间 | 2分钟 | 帐户 | API密钥 | 不适用 |
| 成本 | 自由 | 订阅 | 订阅 | 免费 |
路线图
- [x] 市场搜索、趋势分析、详细信息
- [x] 电动汽车计算+凯利尺寸
- [x] 套利检测
- [x] 新闻情绪边缘发现
- [x] 加密货币价格+恐惧与贪婪
- [x] 纸面交易+投资组合跟踪
- [x] 鲸鱼活动追踪
- [x] 订单簿数据
- [x] 自主代理+仪表板
- []通过Polymarket CLOB API进行实时交易
- []WebSocket实时价格馈送
- []电报/Discord警报系统
- []一键铁路/渲染部署
贡献
PR欢迎。代码库故意简单——纯Python,没有框架,没有数据库。每个工具模块都是独立的。
server.py # MCP server, tool registration
tools_markets.py # Market data (Gamma API, CLOB API)
tools_analysis.py # EV, Kelly, arbitrage math
tools_research.py # News sentiment, edge finding
tools_trading.py # Paper trading, whale tracking, orderbook
tools_crypto.py # CoinGecko prices, Fear/Greed
tools_alerts.py # Alert system
agent.py # Autonomous trading agent
dashboard.py # Web dashboard (Streamlit)
许可证
麻省理工学院