Crypto MCP

下载 OKX / Binance K 线 并缓存到 DuckDB，通过 HTTP streamable MCP 暴露给国内 agent 远程调用。默认走 OKX USDT 永续（超短线合约价）；也可拉 OKX 现货（含代币化美股）和 Binance 现货。

服务设计为部署在海外服务器（直连交易所）；国内客户端把 MCP 地址指向它即可。数据按短线定位：短周期只保留滚动窗口，不全量存储。

本次 schema 含 exchange + market，与旧库不兼容。首次升级请删除 data/crypto/klines.db 后按需重新拉取。

MCP 工具

• symbol：如 BTCUSDT、BTC-USDT、BTC-USDT-SWAP、XTSLAUSDT（OKX 代币化美股现货）、TSLAUSDT（OKX 美股永续）。大小写不敏感。

• interval：1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1M。OKX 不支持 8h；日线及以上用 UTC 开盘（1Dutc 等）。

• exchange：okx | binance。market：spot | swap（Binance 仅 spot）。

Related MCP server: dex-kline-mcp

本地运行

uv sync
uv run crypto-mcp

端点：http://127.0.0.1:8770/mcp/full

海外部署

# 服务器上
uv sync
cp .env.example .env
# 编辑 .env：
#   CRYPTO_MCP_HOST=0.0.0.0
#   CRYPTO_MCP_ALLOW_REMOTE=true
#   （可选）CRYPTO_MCP_HTTP_PROXY=http://127.0.0.1:7890
uv run crypto-mcp

国内客户端（opencode 等）配置示例：

{
  "mcp": {
    "crypto": {
      "type": "remote",
      "url": "http://<海外服务器IP>:8770/mcp/full"
    }
  }
}

保留窗口（短线优先）

每次写库后自动按窗口剪枝（DELETE open_time < now - 窗口），保证短线数据不会无限膨胀。

开发检查

uv run pytest
uv run ruff check .

安全提醒

v0.1 无鉴权。绑定 0.0.0.0 时必须显式设置 CRYPTO_MCP_ALLOW_REMOTE=true；只暴露在可信网络，或前面挂带鉴权的反向代理（如 nginx + basic auth）。