使用说明
binance智能mcp
MCP服务器为币安提供12个计算智能工具。与原始API包装器不同,每个工具将多个Binance端点组合到派生分析中ยทยทยท 累积检测、鲸鱼追踪、市场影响模拟、智能货币雷达、烛台模式扫描、相关矩阵、制度分类、DCA回测、融资率扫描、融资极值检测、融资历史分析和基差扫描。
不需要API密钥 ยทยทยท 所有工具都使用公共Binance端点。
安装
pip install binance-intelligence-mcp
或者从源代码安装:
git clone https://github.com/mefai-dev/binance-intelligence-mcp.git
cd binance-intelligence-mcp
pip install .
快速开始
运行服务器:
binance-intelligence-mcp
# or
python -m binance_intelligence
MCP客户端配置
添加到MCP客户端配置中:
{
"mcpServers": {
"binance-intelligence": {
"command": "binance-intelligence-mcp"
}
}
}
或者使用Python模块:
{
"mcpServers": {
"binance-intelligence": {
"command": "python",
"args": ["-m", "binance_intelligence"]
}
}
}
工具
| # | 工具 | 描述 | 使用的端点 |
|---|---|---|---|
| 1 | detect_accumulation |
具有4个子分数的智能累积检测器 | klines、openInterestHist、premiumIndex、takerBuySellRatio |
| 2 | scan_whale_trades |
带层级分类的大型交易扫描仪 | aggTrades |
| 3 | simulate_market_impact |
用于滑移分析的订单簿行走模拟器 | 深度 |
| 4 | smart_money_radar |
6因素智能货币综合得分 | topLongShortPositionRatio、topLongShortAccountRatio、globalLongShortAccountRatio、takerBuySellRatio、openInterestHist、klines |
| 5 | scan_candlestick_patterns |
经典模式检测与置信度评分 | klines |
| 6 | compute_correlation_matrix |
交易对之间的皮尔逊相关性 | klines |
| 7 | classify_market_regime |
基于ADX和ATR的制度分类 | klines,premiumIndex |
| 8 | backtest_dca |
DCA与一次性退款 | klines |
| 9 | scan_funding_rates |
所有期货对的资金利率热图 | 溢价指数,资金信息 |
| 10 | detect_funding_extremes |
极端融资利率套利机会 | 溢价指数,融资信息 |
| 11 | analyze_funding_history |
某个交易品种的历史融资率分析 | fundingRate |
| 12 | scan_basis_spread |
现货期货基差(期货溢价/现货溢价) | 溢价指数 |
工具详情
1. detect_accumulation
通过将交易量分析、未平仓合约趋势、融资利率接近度和买方买入/卖出比率组合成综合得分(0-100)来检测智能累积。
参数:
symbols(list[str],可选):交易对。默认值:前12个期货对。
分项得分:
volume_surge:当前交易量与20个时期的平均值oi_buildup:未平仓合约线性回归趋势stealth_mode:资金利率接近于零buyer_aggression:买入比率高于中性
输出示例:
{
"tool": "detect_accumulation",
"count": 3,
"results": [
{
"symbol": "ETHUSDT",
"scores": {
"volume_surge": 72.5,
"oi_buildup": 65.3,
"stealth_mode": 89.0,
"buyer_aggression": 58.2
},
"composite": 70.1,
"signal": "STRONG"
}
]
}
2. scan_whale_trades
扫描最近的总交易以识别大额订单。按级别分类:海豚(5万至25万美元)、鲸鱼(25万至100万美元)和巨型(>100万美元。
参数:
symbols(list[str],可选):交易对。默认值:前6对。min_usd(浮动,可选):最小交易规模。默认值:50000。
输出示例:
{
"tool": "scan_whale_trades",
"results": [
{
"symbol": "BTCUSDT",
"trade_count": 15,
"total_buy_usd": 2450000,
"total_sell_usd": 1230000,
"net_pressure_usd": 1220000,
"net_direction": "BUY",
"biggest_trade": {
"usd_value": 1200000,
"side": "BUY",
"tier": "MEGA"
},
"tiers": {"dolphin": 8, "whale": 5, "mega": 2}
}
]
}
3. simulate_market_impact
浏览实时订单簿,模拟大型市价订单的执行方式。
参数:
symbol(str):交易对。默认值:“BTCUSD”。side(str):“买入”或“卖出”。amount_usd(浮动):订单大小(美元)。默认值:100000。
输出示例:
{
"tool": "simulate_market_impact",
"symbol": "BTCUSDT",
"side": "BUY",
"levels_consumed": 12,
"avg_fill_price": 67542.30,
"worst_fill_price": 67580.00,
"slippage_pct": 0.056,
"impact_rating": "MODERATE"
}
4. smart_money_radar
将6个独立的数据因素组合成一个综合得分(0-100)。
参数:
symbols(list[str],可选):默认值:前12对。
因素(每个得分为-1至+1):
- 顶级交易员头寸比率
- 顶级交易员账户比率
- 全球多头/空头账户比率
- 接受者买入/卖出比率
- 未平仓合约趋势
- 价格动量
5. scan_candlestick_patterns
使用置信度得分检测经典烛台模式。
参数:
symbols(list[str],可选):默认值:前12对。interval(str):“1小时”或“4小时”。默认值:“4h”。
检测到的模式: 锤子,倒锤,牛/熊Engulding,Doji,晨星/昏星,三名白人士兵,三只黑乌鸦。
6. compute_correlation_matrix
计算多个交易品种收盘价之间的皮尔逊相关系数。
参数:
symbols(list[str],可选):2-20对。默认值:top 8。interval(str):默认值:“4h”。limit(int):回顾期。默认值:90。
7. classify_market_regime
使用ADX、ATR和体积分析将每个符号分为四种状态之一。
参数:
symbols(list[str],可选):默认值:前12对。
制度:
TRENDING:定向运动强(ADX>=25)RANGING:低方向移动VOLATILE_BREAKOUT:高ADX+高ATRLOW_ACTIVITY:低交易量和波动性
8. backtest_dca
根据历史数据对美元成本平均值与一次性投资进行反向测试。
参数:
symbol(str):默认值:“BTCUSD”。amount_per_interval(浮动):每次购买美元。默认值:100。interval_days(int):购买之间的天数。默认值:7(每周)。total_days(int):历史回顾。默认值:365。
9. scan_funding_rates
扫描所有期货对的当前融资利率,生成按绝对利率排序的热图。
参数:
top_n(int,可选):结果数。默认值:20。
输出包括: 利率%、年化APR、标记/指数溢价、下一次融资的分钟数、方向(LONGS_PAY/SHORTS_PAY/NEUTRAL)。
10. detect_funding_extremes
通过严重性分类和套利提示检测所有货币对的极端融资率。
严重程度: 升高(>0.03%)、高(>0.05%)、极端(>0.1%)
输出包括: 严重性、机会得分、紧迫性(即时/即将/即将)、套利提示。
11. analyze_funding_history
使用综合统计数据分析单个交易品种的历史融资率。
参数:
symbol(str):默认值:“BTCUSD”。limit(int):历史时期。默认值:500。
输出包括: 平均/中位数/std-dev、趋势方向、累计成本、年化成本、波动性得分(0-100)、分布。
12. scan_basis_spread
扫描所有对的现货期货基差,识别期货溢价和现货溢价。
参数:
top_n(int,可选):结果数。默认值:20。
输出包括: 基差%,州(CONTANGO/BACKWARDING/FLAT),根据资金利率按年计算。
建筑
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท MCP Client ยทยท
ยทยท (any MCP-compatible client) ยทยท
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทฌยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท stdio (JSON-RPC)
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทผยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท server.py (FastMCP) ยทยท
ยทยท 12 @mcp.tool() functions ยทยท
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทฌยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทผยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท tools/*.py ยทยท
ยทยท Pure async functions with scoring algorithms ยทยท
ยทยท ยทยท
ยทยท accumulation ยทยท whale ยทยท impact ยทยท smart_money ยทยท
ยทยท patterns ยทยท correlation ยทยท regime ยทยท dca ยทยท
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทฌยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทผยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท client.py (BinanceClient) ยทยท
ยทยท Async aiohttp ยทยท Rate limiting ยทยท No API key ยทยท
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทฌยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท HTTPS
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทผยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
ยทยท Binance Public API ยทยท
ยทยท api.binance.com ยทยท fapi.binance.com ยทยท
ยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท
使用的币安端点
所有端点都是 公共 并且不需要认证:
| 端点 | 类型 | 使用人 |
|---|---|---|
/fapi/v1/klines |
期货 | 积累、智能货币、模式、相关性、制度、dca |
/fapi/v1/aggTrades |
未来 | 鲸鱼 |
/fapi/v1/depth |
未来 | 影响 |
/fapi/v1/premiumIndex |
期货 | 积累、制度、资金扫描、资金极端、基差 |
/futures/data/openInterestHist |
期货 | 积累,智能货币 |
/futures/data/topLongShortPositionRatio |
期货 | 智能货币 |
/futures/data/topLongShortAccountRatio |
期货 | 智能货币 |
/futures/data/globalLongShortAccountRatio |
期货 | 智能货币 |
/futures/data/takerlongshortRatio |
期货 | 积累,智能货币 |
/fapi/v1/fundingInfo |
期货 | 融资_扫描,融资_极端 |
/fapi/v1/fundingRate |
期货 | 融资历史 |
/api/v3/klines |
现货 | (可用) |
发展
git clone https://github.com/mefai-dev/binance-intelligence-mcp.git
cd binance-intelligence-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e . pytest pytest-asyncio
运行测试:
pytest tests/ -v
所有测试都是基于模拟的ยทยทยท 不需要API密钥或网络访问。
许可证
麻省理工学院
