加密货币交易服务器

# Clone the repository
git clone https://github.com/forgequant/mcp-provider-binance.git
cd mcp-provider-binance

# Build the MCP server (with orderbook features)
cargo build --release --features orderbook

# Verify installation
./target/release/mcp-binance-server --version

# Local stdio mode (default)
cargo build --release --features orderbook

# Local SSE testing
cargo build --release --features sse,orderbook_analytics

# Shuttle deployment (use shuttle deploy instead)
shuttle deploy --features shuttle-runtime,orderbook_analytics

# Run in stdio mode (default)
cargo run --features orderbook

# Run in SSE mode
cargo run --features sse,orderbook -- --mode sse --port 8000

{
  "mcpServers": {
    "binance": {
      "command": "cargo",
      "args": [
        "run",
        "--release",
        "--features",
        "orderbook",
        "--manifest-path",
        "/path/to/mcp-provider-binance/Cargo.toml"
      ],
      "env": {
        "BINANCE_API_KEY": "your_testnet_api_key",
        "BINANCE_SECRET_KEY": "your_testnet_secret_key",
        "BINANCE_BASE_URL": "https://testnet.binance.vision",
        "RUST_LOG": "info"
      }
    }
  }
}

# 1. Login to Shuttle
shuttle login

# 2. Deploy with SSE transport (creates HTTPS endpoint automatically)
shuttle deploy --features shuttle-runtime,orderbook_analytics

# 3. Configure secrets (Binance API credentials)
shuttle secrets add BINANCE_API_KEY=your_testnet_api_key
shuttle secrets add BINANCE_API_SECRET=your_testnet_secret_key

# 4. Get deployment URL
shuttle status
# Returns: https://mcp-provider-binance.shuttleapp.rs

# 5. View logs
shuttle logs

{
  "mcpServers": {
    "binance-cloud": {
      "url": "https://mcp-provider-binance.shuttleapp.rs/mcp/sse",
      "transport": "sse"
    }
  }
}

# Start SSE server on localhost
cargo run --features sse,orderbook_analytics -- --mode sse --port 8000

# Test health endpoint
curl http://localhost:8000/health

# Test SSE handshake
curl -H "Accept: text/event-stream" -i http://localhost:8000/mcp/sse

Response: {
  "serverTime": 1699564800000,
  "offset": -125
}

Response: {
  "symbol": "BTCUSDT",
  "priceChange": "1234.56",
  "priceChangePercent": "2.5",
  "lastPrice": "50000.00",
  "volume": "12345.67",
  "highPrice": "51000.00",
  "lowPrice": "49000.00"
}

Response: {
  "bids": [["3000.00", "10.5"], ["2999.50", "5.2"]],
  "asks": [["3001.00", "8.3"], ["3001.50", "12.1"]]
}

Response: {
  "symbol": "BTCUSDT",
  "timestamp": 1699564800123,
  "spread_bps": 0.15,
  "mid_price": "67650.50",
  "bid_liquidity_10bps": "123.45",
  "ask_liquidity_10bps": "98.76",
  "walls": {
    "bids": [{"price": "67500.00", "qty": "50.0"}],
    "asks": []
  }
}

Response: {
  "symbol": "ETHUSDT",
  "timestamp": 1699564800123,
  "price_scale": 100,
  "qty_scale": 100000,
  "bids": [
    [308500, 1050000],  // $3085.00, 10.5 ETH
    [308450, 520000]    // $3084.50, 5.2 ETH
  ],
  "asks": [
    [308600, 830000],   // $3086.00, 8.3 ETH
    [308650, 1210000]   // $3086.50, 12.1 ETH
  ]
}

Response: {
  "status": "ok",
  "orderbook_symbols_active": 3,
  "last_update_age_ms": 127,
  "websocket_connected": true,
  "reason": null
}

Response: {
  "balances": [
    {"asset": "BTC", "free": "0.5", "locked": "0.0"},
    {"asset": "USDT", "free": "10000.00", "locked": "500.00"}
  ],
  "canTrade": true,
  "canWithdraw": false,
  "canDeposit": false
}

Response: {
  "orderId": 12345,
  "symbol": "BTCUSDT",
  "status": "NEW",
  "side": "BUY",
  "type": "LIMIT",
  "price": "50000.00",
  "origQty": "0.001"
}

You: "What's the current Bitcoin price?"
Claude: [Uses get_ticker] "Bitcoin is currently trading at $50,234.56..."

You: "Show me the order book depth for ETHUSDT"
Claude: [Uses get_order_book] "Here's the ETHUSDT order book..."

You: "Show me orderbook metrics for BTCUSDT"
Claude: [Uses get_orderbook_metrics] "BTCUSDT orderbook metrics:
- Spread: 0.15 bps (tight spread, good liquidity)
- Mid Price: $67,650.50
- Bid liquidity within 10 bps: 123.45 BTC
- Ask liquidity within 10 bps: 98.76 BTC
- Large wall detected at $67,500 (50 BTC)"

You: "Get detailed depth with 20 levels"
Claude: [Uses get_orderbook_depth with levels=20] "Here's the L2 depth for BTCUSDT:
Top 3 bids: $67,650.00 (1.2 BTC), $67,649.50 (0.8 BTC), $67,649.00 (1.5 BTC)
Top 3 asks: $67,650.50 (0.9 BTC), $67,651.00 (1.1 BTC), $67,651.50 (0.7 BTC)"

You: "Is the orderbook service healthy?"
Claude: [Uses get_orderbook_health] "Orderbook service is healthy:
- Status: OK
- Active symbols: 3
- Last update: 127ms ago
- WebSocket: Connected"

You: "What's my account balance?"
Claude: [Uses get_account_info] "Your account has 0.5 BTC and 10,000 USDT..."

You: "Place a test buy order for 0.001 BTC at 49000"
Claude: [Uses place_order] "Order placed successfully! Order ID: 12345..."

You: "Show my open orders"
Claude: [Uses get_open_orders] "You have 3 open orders..."

You: "Analyze BTCUSDT for aggressive trading"
Claude: [Uses trading_analysis prompt] "Based on current market data:
- Current Price: $50,234.56 (+2.5% in 24h)
- Volume: Strong upward momentum
- Recommendation: Consider entering long positions
- Risk Factors: High volatility, monitor support at $49,000"

You: "Assess my portfolio risk"
Claude: [Uses portfolio_risk prompt] "Portfolio Risk Analysis:
- Total Balance: $15,234.56 (0.5 BTC + 10,000 USDT)
- Risk Level: Moderate
- BTC Exposure: 33%
- Recommendations: Diversify into stable assets..."

You: "Analyze BTCUSDT market microstructure"
Claude: [Uses market_microstructure_analysis prompt] "
# BTCUSDT Market Microstructure Analysis

## Volume Profile (Last 24h)
- POC: $67,850 (high-volume node, strong support)
- VAH: $68,200 (70% value area upper bound)
- VAL: $67,500 (70% value area lower bound)
- Current price vs POC: +0.3% (trading at fair value)

## Market Anomalies
⚠️ Quote Stuffing detected (High severity)
- Update rate: 750/sec (>500 threshold)
- Fill rate: 8% (<10% threshold)
- Action: Delay execution, widen spreads

## Market Health: 78.5 (Good)
- Spread stability: 85.2 (excellent)
- Liquidity depth: 92.1 (excellent)
- Flow balance: 68.3 (good)
- Update rate: 72.0 (good)

Recommendation: Normal trading conditions with caution around HFT activity windows."

You: "Get order flow signals for ETHUSDT"
Claude: [Uses order_flow_trading prompt] "
# ETHUSDT Order Flow Analysis (Last 5 min)

## Flow Metrics
- Buy volume: 245.3 ETH
- Sell volume: 198.7 ETH
- Imbalance ratio: 0.552 (moderate bullish pressure)
- Net pressure: +46.6 ETH

## Signal: LONG BIAS ✅
- Aggressor buys dominating (55% of volume)
- Institutional accumulation detected (3 large buy orders)
- Recommendation: Look for entries on minor pullbacks
- Stop loss: Below recent swing low ($3,045)
- Target: VAH level ($3,086)"

You: "Map liquidity for SOLUSDT"
Claude: [Uses liquidity_mapping prompt] "
# SOLUSDT Liquidity Map

## Liquidity Vacuums 🕳️
1. $145.50 - $148.20 (High severity)
   - Avg volume: 12.5 SOL (85% below median)
   - Risk: Rapid price discovery, avoid stops here

2. $142.00 - $143.50 (Medium severity)
   - Avg volume: 34.8 SOL (55% below median)

## Order Walls 🧱
- Bid wall: $144.00 (250 SOL) - Strong support
- Ask wall: $150.00 (310 SOL) - Resistance zone

## Stop Loss Guidance
- Safe zones: Below $143.80 or above $148.50 (outside vacuums)
- Risky zones: $145-$148 (vacuum zone, likely to get run)

Current price: $146.75 (inside vacuum - expect volatility)"

You: "Show me the BTCUSDT market resource"
Claude: [Reads binance://market/btcusdt] "# BTCUSDT Market Data
Current Price: $50,234.56
24h Change: +$1,234.56 (+2.5%)
Volume: 12,345.67 BTC
High: $51,000.00 | Low: $49,000.00"

You: "Show my account balances resource"
Claude: [Reads binance://account/balances] "# Account Balances

| Asset | Free Balance | Locked Balance | Total |
|-------|--------------|----------------|-------|
| BTC   | 0.50000000   | 0.00000000     | 0.50000000 |
| USDT  | 10000.00     | 500.00         | 10500.00 |"

You: "Show my open orders resource"
Claude: [Reads binance://orders/open] "# Open Orders

| Order ID | Symbol  | Side | Type  | Price     | Quantity | Status |
|----------|---------|------|-------|-----------|----------|--------|
| 12345    | BTCUSDT | BUY  | LIMIT | 49000.00  | 0.001    | NEW    |"

{
  "code": -32001,
  "message": "Rate limit exceeded. Please wait 60 seconds before retrying.",
  "data": {
    "retry_after_secs": 60,
    "current_weight": 1200,
    "weight_limit": 1200,
    "recovery_suggestion": "Reduce request frequency or wait for rate limit window to reset"
  }
}

# Build with HTTP + orderbook features
cargo build --release --features http-api,websocket,orderbook

# Configure
export HTTP_BEARER_TOKEN="your_secure_token"
export HTTP_HOST="0.0.0.0"
export HTTP_PORT="3000"
export BINANCE_API_KEY="your_key"
export BINANCE_SECRET_KEY="your_secret"

# Start server
./target/release/mcp-binance-server

# Core features only (13 tools)
cargo build --release

# Add orderbook depth tools (16 tools)
cargo build --release --features orderbook

# Add advanced analytics tools (21 tools total = 16 + 5 analytics)
cargo build --release --features orderbook_analytics

# Add HTTP API + WebSocket
cargo build --release --features http-api,websocket

# All features
cargo build --release --features orderbook_analytics,http-api,websocket

"command": "/path/to/.cargo/bin/cargo"

git pull
cargo build --release

Large time offset detected: 6000ms. Consider syncing system clock.

# macOS
sudo sntp -sS time.apple.com

# Linux
sudo ntpdate -u pool.ntp.org

src/
├── server/         # MCP protocol implementation
│   ├── mod.rs      # BinanceServer struct
│   ├── handler.rs  # ServerHandler implementation
│   └── tool_router.rs  # Tool routing and implementations
├── binance/        # Binance API client
│   ├── client.rs   # HTTP client
│   └── types.rs    # API response types
├── config/         # Configuration management
├── error.rs        # Error handling
└── main.rs         # Entry point

# Run all tests
cargo test

# Run tests with orderbook features
cargo test --features orderbook

# Run integration tests
cargo test --test '*' --features orderbook

# Run performance tests
cargo test --features orderbook --release -- --nocapture test_l1_metrics_performance
cargo test --features orderbook --release -- --nocapture test_l2_depth_performance

# Run with logging
RUST_LOG=debug cargo test --features orderbook

# Test specific tool
cargo test test_get_ticker
cargo test test_orderbook_metrics --features orderbook

# Add required secrets
shuttle secrets add BINANCE_API_KEY=your_testnet_key
shuttle secrets add BINANCE_API_SECRET=your_testnet_secret

# Verify secrets are set
shuttle secrets list

# Always include base feature when using analytics
cargo build --features orderbook_analytics  # ❌ Wrong
cargo build --features orderbook,orderbook_analytics  # ✅ Correct

# Run tests sequentially (orderbook_analytics uses shared RocksDB)
cargo test --features orderbook_analytics -- --test-threads=1