Cryptoconduit Mcp

CryptoConduit MCP

一个 MCP 服务，让 AI Agent 能直接访问 Polymarket 加密货币预测市场，并结合实时现货价格。通过自然语言发现市场、分析订单簿、模拟策略交易、追踪活动并执行实盘交易。

使用 Rust 构建。包含 22 个工具。已在主网上测试。

你可以将其用作 MCP 服务，搭配任何兼容 MCP 的客户端；也可以将 core/ 库直接导入自己的 Rust 机器人和流水线中，无需依赖 MCP。

---

功能

市场情报 — 发现并监控覆盖 6 种资产（BTC、ETH、SOL、XRP、DOGE、BNB）和 8 种市场类型（5 分钟至月度）的预测市场。在 Polymarket 订单簿上叠加实时 Binance 现货价格，并提供可交易性评分、价差分析和深度分析。

量化分析 — 识别现货动量、订单簿动态（价差趋势、深度变化、失衡）、概率与现货价格偏离，以及鲸鱼资金流向，并整合为每个市场的一份简报。如果没有本地历史记录，分析会改为查询 Gamma 上已结算的市场，以获取历史交易量和活动背景。

模拟交易 — 根据 Polymarket 的手续费模型模拟经手续费调整后的盈亏。支持完整的投资组合跟踪、自动自主交易执行、提前退出和仓位管理。在投入真实资金前无风险测试策略。

实盘交易 — 通过官方 SDK 在 Polymarket 上下单和管理真实订单。三重安全机制：默认进行模拟运行、必须明确确认，并由风险管理器执行每日亏损限额、回撤跟踪和连续亏损暂停。

监控 — 始终运行的后台系统：监测 Polymarket 实时交易流中的鲸鱼交易、价差收窄提醒、深度激增检测和临近时间窗口通知。无需手动设置。

---

工具

发现与数据

工具	功能
search_crypto_markets	搜索 Polymarket 上的加密货币预测市场。可按资产、市场类型（5 分钟、每日、每月等）筛选，并按价差或交易量排序。返回包含当前价格、价差和流动性的活跃市场。
get_active_window	当前 5 分钟或 15 分钟预测窗口的快照，包括剩余时间、现货价格、UP/DOWN 双方的最优买价/卖价、价差和深度。
get_window_briefing	更丰富的活跃窗口信息，额外提供开盘以来的现货价格变动、1 小时波动率概况、手续费盈亏平衡计算，以及各方的可交易性评分。
get_spot_price	获取任何受支持资产当前的 Binance 现货价格，并显示数据时效指标。
get_order_book	获取特定市场代币的完整订单簿，包括所有买卖价位、总深度、集中度分析，以及不同交易规模下的滑点估算。
get_market_analysis	主要分析工具。结合 5 个维度：现货动量（1 分钟/5 分钟/15 分钟趋势、加速度、波动率）、订单簿动态（价差趋势、深度不对称、历史统计）、概率偏离（经验模型与市场价格对比）、鲸鱼资金流向，以及近期提醒。本地历史记录不可用时，会改为查询 Gamma 上已结算的市场。适用于 5 分钟、15 分钟、每日和每月市场。
get_whale_activity	获取每日和每月市场中近期的大额交易（5 千美元以上），数据来自 Polymarket 实时交易流。过滤微型市场噪声和结算后的赎回记录。
get_alerts	获取后台监控器生成的提醒：价差收窄、深度激增、鲸鱼交易，以及即将到期的时间窗口。

模拟与纸面交易

工具	功能
simulate_trade	根据费用调整盈亏的计算器。输入仓位大小和价格，即可查看盈利和亏损情景下的准确盈亏，其中包含 Polymarket 的吃单手续费、挂单返佣和结算计算。显示盈亏平衡胜率。
paper_trade	按当前市场价格开设模拟仓位。跟踪入场价格、手续费和时间戳。市场在 Polymarket 上结算后，仓位会自动结算。
get_paper_portfolio	完整的投资组合视图——显示带实时倒计时的未平仓仓位、已结算结果、按资产和入场价格区间划分的胜率、总盈亏及手续费跟踪。
paper_close	按当前买价提前退出纸面仓位，退出时支付吃单手续费。显示包含入场和退出手续费的已实现盈亏。
set_auto_paper_trade	配置自主纸面交易。设置资产、仓位大小和入场条件——服务会监控市场，并在满足条件时自动开仓。
get_auto_paper_trade_status	查看哪些自动交易器正在运行、近期交易和汇总统计数据。

实盘交易

需要配置钱包。请参阅下文的钱包设置。

工具	功能
approve_exchange	一次性链上设置。为 Polymarket 的 3 个交易合约授权 USDC 和 CTF 代币转账。POL Gas 费用约为 $0.001。下单前必须运行。
get_balance	Polygon 上钱包的 USDC.e 余额，以及风险管理器状态（每日剩余亏损额度、连续亏损次数、回撤）。
place_order	下买单或卖单。默认先模拟运行——显示将会发生什么，但不会提交订单。必须明确设置 confirm=true 才会执行。受风险管理器约束。
cancel_order	按订单 ID 取消指定订单，或一次性取消所有未成交订单。
get_positions	钱包中的当前实盘仓位。
redeem_winnings	市场结算后，在链上赎回获胜的 CTF 代币。适用于标准市场和 NegRisk 市场。

系统

工具	功能
set_data_logging	开启或关闭后台 JSONL 日志记录，记录现货价格、订单簿和市场快照。适用于构建数据集或调试。
get_data_logging_status	查看日志记录是否已启用、文件保存位置及当前磁盘使用量。

---

示例输出

时段简报

## BTC 5m Briefing (2:25 AM ET)

Time: 9% elapsed (26s / 300s), 274s remaining
Spot: $70822 -> $70843 (+0.03%)
Volatility (1h): avg 5m move: 0.051% | max: 0.146% | moves >0.05%: 5/12
UP:   ask=0.660 bid=0.650 spread=1.5% | good (depth: $755, slippage $100: 2.0%)
DOWN: ask=0.350 bid=0.340 spread=2.9% | good (depth: $127, slippage $100: 2.3%)
Fees (taker): UP at 0.660: fee=1.3%, breakeven WR=67.3%
              DOWN at 0.350: fee=1.3%, breakeven WR=36.3%

市场分析（每日）

## BTC Market Analysis (daily)

### Spot Momentum
  Price           $70795    Trend        Down
  1m move         -0.085%   5m vol       0.055%
  5m move         -0.039%   Accel        decel (-0.078)
  15m move        -0.167%

$70795 — downtrend, decelerating. High volatility.

### Order Book Dynamics
  ATM strike: $70000 (spot: $70795)

  Side     Spread   Median       Trend    BidDep$    AskDep$  Imbalance
  ------------------------------------------------------------------------
  YES        1.3%     1.3%      stable       $169       $221  Mild ask pressure
  NO         3.9%     3.9%      stable        $74        $59  Mild bid pressure

YES side has better liquidity (tighter spread, deeper book).

### Probability Divergence
  Side     Market  Fair Est.  Divergence           Method       Conf
  --------------------------------------------------------------------
  YES       0.750     0.842   +0.092 (underpriced) vol-CDF      high
  NO        0.260     0.158   -0.102 (overpriced)  vol-CDF      high

YES looks underpriced (+9.2%). NO looks overpriced (-10.2%).

纸面投资组合

## Paper Portfolio

Trades: 9 | Wins: 5 | Win rate: 55.6%
Total P&L: $11.66 | Avg P&L: $1.30
Volume: $55.00 | Fees paid: $1.69

By Asset:
  BTC:  4 trades, 50.0% WR, $3.71 P&L
  ETH:  2 trades, 50.0% WR, $3.40 P&L
  SOL:  1 trades, 100.0% WR, $5.04 P&L
  XRP:  1 trades, 100.0% WR, $4.65 P&L

By Entry Price:
  0.30-0.50: 3 trades, 66.7% WR, $9.86 P&L
  0.50-0.70: 6 trades, 50.0% WR, $1.80 P&L

---

要求

• 平台： Windows、macOS、Linux
• 网络： 需要访问 Polymarket 和 Binance API。

无需 API 密钥。 Polymarket 和 Binance 的市场数据 API 均为公开 API。服务开箱即用——无需账户、注册或令牌。只有启用实盘交易时才需要 API 密钥（请参阅钱包设置）。

快速开始

选项 A：下载预编译二进制文件

从 Releases 下载适用于你平台的最新二进制文件，并将其放在 PATH 中的某个位置（或记下完整路径，以便填写下方配置）。

选项 B：从 crates.io 安装

需要 Rust 1.85+。

cargo install crypto-conduit-mcp

连接到 MCP 客户端

添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "crypto-predict": {
      "command": "crypto-conduit-mcp"
    }
  }
}

如果二进制文件不在 PATH 中，请改用完整路径（例如 "/path/to/crypto-conduit-mcp" 或 "C:\\Users\\you\\crypto-conduit-mcp.exe"）。

该服务通过 stdio 使用 Model Context Protocol 进行通信。

首次启动： 服务需要约 30-45 秒从 Polymarket 发现所有活跃市场。在此期间，部分工具可能只能显示有限的数据。完成初始发现周期后，所有内容都会持续更新。

启动后，服务会自动：

• 每 4 分钟发现新市场
• 轮询订单簿（短期市场每 5 秒一次，每日／每月市场每 30 秒一次）
• 每 3 秒流式获取 Binance 现货价格
• 监控 Polymarket 实时交易流中的大户活动
• 生成提醒（价差收窄、深度激增、窗口临近）

所有这些都在后台运行——工具从此缓存状态中读取数据，因此响应即时返回。

配置（可选）

服务无需配置文件即可运行。如需自定义，请在适用于你平台的位置创建配置文件：

• Windows： %APPDATA%\crypto-conduit\config.toml
• macOS： ~/Library/Application Support/crypto-conduit/config.toml
• Linux： ~/.config/crypto-conduit/config.toml

[logging]
enabled = false          # background data logging (JSONL files)

# [trading]              # uncomment for live trading — see Wallet Setup below
# private_key = "..."
# max_order_size_usd = 100

---

钱包设置（实盘交易）

实盘交易需要配置钱包。模拟交易无需进行这些设置。

1. 创建或使用 EOA 钱包

你需要一个 Polygon 上的外部拥有账户（EOA）。可以使用 MetaMask 钱包、专用交易钱包，或任何兼容 Ethereum 的钱包。请勿使用你的主钱包——请创建一个专用于交易的钱包。

2. 为钱包注资

• Polygon 上的 USDC.e（桥接 USDC）——这是 Polymarket 使用的抵押代币。合约：0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174。不是原生 USDC（0x3c499...）。
• 少量 POL，用于支付 Gas 费用（链上授权费用约为 $0.001）。

3. 将私钥添加到配置中

[trading]
private_key = "abc123..."   # 64 hex characters, no 0x prefix
wallet_type = "eoa"
max_order_size_usd = 100    # safety cap per order
daily_loss_limit_usd = 50   # risk manager halts trading if exceeded

安全性： 你的私钥绝不会被记录——服务使用经过隐藏处理的 Debug 实现。不过，仍请限制此配置文件的访问权限。

4. 授权交易所合约

在下第一笔订单前，运行 approve_exchange 工具。这是一笔一次性的链上交易，用于授权 Polymarket 的 3 个交易所合约（CTF Exchange、Neg Risk CTF Exchange、Neg Risk Adapter）转移 USDC 和 CTF 代币。

5. 下单

所有订单默认采用模拟运行模式——仅展示将会发生什么，不会提交任何内容。要执行真实订单，请设置 confirm=true。风险管理器会在每笔订单执行前检查每日亏损限额、连续亏损和回撤情况。

---

示例提示词

通过 MCP 连接后，可以尝试向你的 AI Agent 提出以下请求：

发现与分析

• “当前有哪些 BTC 日线市场处于活跃状态？按价差从小到大排序”
• “简要介绍一下当前 ETH 5m 窗口”
• “对 BTC 日线市场进行完整的市场分析”
• “显示 BTC $70k 行权价的订单簿”

模拟

• “如果我以 0.75 买入 $50 的 BTC 日线 YES，赢了和输了分别会有多少盈亏？”
• “以 0.65 入场，需要多高的胜率才能达到盈亏平衡？”

模拟交易

• “模拟交易 $10 的 BTC 5m UP”
• “显示我的模拟交易组合——有已结算的持仓吗？”
• “平掉持仓 #3”
• “设置 ETH 5m 自动模拟交易：$5 仓位，低于 0.45 时入场，且仅在现货价格变动超过 0.1% 时交易”

实盘交易

• “检查我的钱包余额和风险状态”
• “模拟运行：以 0.52 买入 $10 的 ETH 日线 YES”
• “取消我所有未成交的订单”

监控

• “过去 30 分钟内有大户交易或提醒吗？”
• “显示所有资产近期的大户活动”

---

用作 Rust 库

core/ 模块与 MCP 完全没有依赖——它是一个独立库。可直接导入，用于自定义机器人、数据管道或其他接口：

use crypto_conduit::core::providers::binance;
use crypto_conduit::core::analysis::fees;
use crypto_conduit::core::paper::portfolio;

Supported assets

Asset	Binance Pair	5m	15m	Hourly	Daily	Monthly
BTC	BTCUSDT	Yes	Yes	Yes	Yes	Yes
ETH	ETHUSDT	Yes	Yes	Yes	Yes	Yes
SOL	SOLUSDT	Yes	Yes	Yes	Yes	Yes
XRP	XRPUSDT	Yes	Yes	Yes	Yes	Yes
DOGE	DOGEUSDT	Yes	Yes	Yes	Yes	Yes
BNB	BNBUSDT	Yes	Yes	Yes	Yes	No

Architecture

src/
├── main.rs              ← MCP server entry point
├── mcp/                 ← MCP tool layer (thin wrappers)
│   ├── mod.rs           ← Tool registration
│   ├── tools_*.rs       ← Tool handlers by category
│   └── formatter.rs     ← Response formatting
└── core/                ← Standalone library (no MCP dependency)
    ├── types.rs          ← Shared types
    ├── providers/        ← API clients (Polymarket, Binance, Chainlink)
    ├── analysis/         ← Fee model, momentum, book dynamics, divergence
    ├── paper/            ← Paper trading engine
    ├── execution/        ← Live trading (Polymarket SDK, risk manager)
    └── monitor/          ← Background polling, alerts, whale tracking, auto-trade

License

AGPL-3.0 — see LICENSE for details.