AI导哈

Bybit MCP服务器

一个为Bybit V5 API设计的模型上下文协议服务器，用于连接AI助手进行市场数据获取、交易和账户管理。

  • by workspace
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 workspace/bybit-mcp-server

使用说明

bybit mcp服务器

A. 模型上下文协议 服务器 Bybit V5 API。

将人工智能助手（Claude、Cursor等）连接到Bybit，用于市场数据、交易和账户管理——通过stdio在本地或通过带有OAuth身份验证的HTTP远程连接。

快速开始

本地（stdio）

uvx bybit-mcp-server

远程（Docker）

docker pull ghcr.io/workspace/bybit-mcp-server:latest
docker run -p 8000:8000 \
  -e BYBIT_MCP_ADMIN_PASSWORD=your-password \
  -e BYBIT_MCP_SECRET_KEY=$(python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())") \
  -e BYBIT_MCP_ISSUER_URL=https://your-server.example.com \
  -v bybit-data:/app/data \
  ghcr.io/workspace/bybit-mcp-server:latest

运输方式

模式 传输 身份验证 凭据 用例
本地 stdio 无 环境变量 克劳德桌面，光标
远程 streamable-http OAuth 2.0 Web设置页面 克劳德自定义连接器，共享服务器

MCP客户端配置

克劳德桌面（本地）

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "bybit": {
      "command": "uvx",
      "args": ["bybit-mcp-server"],
      "env": {
        "BYBIT_API_KEY": "your-api-key",
        "BYBIT_API_SECRET": "your-api-secret",
        "BYBIT_TESTNET": "true"
      }
    }
  }
}

克劳德定制连接器（远程）

  1. 使用Docker部署服务器（请参阅 部署)
  2. 在Claude设置中，添加自定义连接器：
    • 统一资源定位符: https://your-server.example.com
  3. Claude会自动处理OAuth——系统会提示您使用管理员凭据登录
  4. 连接后，访问 https://your-server.example.com/settings 输入您的Bybit API密钥

光标（本地）

增添 .cursor/mcp.json:

{
  "mcpServers": {
    "bybit": {
      "command": "uvx",
      "args": ["bybit-mcp-server"],
      "env": {
        "BYBIT_API_KEY": "your-api-key",
        "BYBIT_API_SECRET": "your-api-secret",
        "BYBIT_TESTNET": "true"
      }
    }
  }
}

可用工具（27）

类别 工具 权限
市场 get_tickers, get_kline, get_orderbook, get_instruments_info, get_server_time, get_funding_rate_history, get_public_trades, get_open_interest read
账户 get_wallet_balance, get_fee_rate, get_account_info read
贸易 place_order, amend_order, cancel_order, cancel_all_orders, get_open_orders, get_order_history, get_trade_history trade
位置 get_positions, set_leverage, set_trading_stop, set_auto_add_margin, get_closed_pnl read / trade
资产 get_coin_balance, get_coin_info, get_transfer_history, internal_transfer read / full

部署

Docker Compose

services:
  bybit-mcp:
    image: ghcr.io/workspace/bybit-mcp-server:latest
    ports:
      - "8000:8000"
    environment:
      - BYBIT_MCP_ADMIN_PASSWORD=your-secure-password
      - BYBIT_MCP_SECRET_KEY=your-fernet-key
      - BYBIT_MCP_ISSUER_URL=https://your-server.example.com
    volumes:
      - bybit-data:/app/data
    restart: unless-stopped

volumes:
  bybit-data:

生成Fernet密钥：

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

环境变量

本地模式（stdio）

变量 默认值 描述
BYBIT_API_KEY - Bybit中的API密钥
BYBIT_API_SECRET - Bybit的API机密
BYBIT_TESTNET true 使用测试网(true)或主网(false)
BYBIT_MODE read 权限模式： read, trade，或 full
BYBIT_RECV_WINDOW -- 请求接收窗口（毫秒）

远程模式（可流式传输http）

变量 默认值 描述
BYBIT_MCP_TRANSPORT stdio 设置为 streamable-http 用于远程模式
BYBIT_MCP_HOST 0.0.0.0 HTTP绑定地址
BYBIT_MCP_PORT 8000 HTTP端口
BYBIT_MCP_ADMIN_USERNAME admin 管理员登录用户名
BYBIT_MCP_ADMIN_PASSWORD -- 管理员登录密码（必填）
BYBIT_MCP_SECRET_KEY - 用于在静止时加密API密钥的Fernet密钥（必需）
BYBIT_MCP_ISSUER_URL -- 带有方案的公共URL，例如。 https://bybit.example.com （必填）
BYBIT_MCP_DB_PATH ./bybit_mcp.db SQLite数据库文件路径

发展

git clone https://github.com/workspace/bybit-mcp-server.git
cd bybit-mcp-server
uv sync --all-extras
uv run pytest
uv run bybit-mcp-server

文档

完整文档请访问 workspace.github.io/bybit-mcp服务器

许可证

麻省理工学院

相关 MCP