Bybit MCP Server

简介

Bybit MCP 服务器是一个模型上下文协议 (MCP)服务器，提供对 Bybit 加密货币交易所 API 的只读访问。

⚠️ 警告： 这是 ALPHA 版本软件，使用风险自负！始终仅使用只读 API 密钥。

安装要求

• Node.js (v20+)
• pnpm (npm i -g pnpm)
• Ollama（可选，用于客户端交互）

快速开始

1. 安装依赖

pnpm i

2. 配置环境变量

cp .env.example .env
# 编辑 .env 文件添加你的 Bybit API 凭证

3. 启动服务器

仅 MCP 服务器:

pnpm serve

MCP 服务器 + Ollama 客户端:

# 安装客户端依赖
(cd client && pnpm i)

# 配置客户端环境
cp client/.env.example client/.env
# 编辑 client/.env 设置 Ollama 参数

# 启动服务器和客户端
pnpm start

可用工具

• get_ticker: 获取实时行情信息
• get_orderbook: 获取订单簿数据
• get_kline: 获取 K 线/蜡烛图数据
• get_market_info: 获取市场信息
• get_trades: 获取最近成交记录
• get_instrument_info: 获取交易对详情
• get_wallet_balance: 获取钱包余额
• get_positions: 获取当前持仓
• get_order_history: 获取订单历史

客户端示例使用

You: USDT/BTC 当前的现货价格是多少？

A: <tool>get_ticker</tool>
<arguments>
{
  "category": "spot",
  "symbol": "BTCUSDT"
}
</arguments>

Tool result: {
  "timestamp": "2024-12-14T12:32:30.628Z",
  "meta": {
    "requestId": "ad5177bc-93d1-49ed-80a1-dd95b3ec970b"
  },
  "symbol": "BTCUSDT",
  "category": "spot",
  "lastPrice": "101368.71",
  ...
}

USDT/BTC 当前的现货价格是 $101,368.71。

MCP 客户端集成

Claude 桌面版配置

位置: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bybit": {
      "command": "node",
      "args": ["/path/to/bybit-mcp/build/index.js"],
      "env": {
        "BYBIT_API_KEY": "your-api-key",
        "BYBIT_API_SECRET": "your-api-secret",
        "BYBIT_USE_TESTNET": "false"
      }
    }
  }
}

gomcp 配置

位置: ~/.config/gomcp/config.yaml

mcp_servers:
  - name: "bybit"
    command: "cd /path/to/bybit-mcp && pnpm run serve"
    arguments: []
    env:
      BYBIT_API_KEY: ""      # 添加只读 API 密钥
      BYBIT_API_SECRET: ""   # 添加只读 API 密码
      BYBIT_USE_TESTNET: "true"  # 生产环境设为 false

更多详细信息请参考客户端 README文档。