MCP Bybit API Interface

MCP Bybit API 接口

Bybit MCP（模型上下文协议）服务。通过 MCP 工具提供便捷接口，用于与 Bybit V5 API 交互。可通过封装为工具的 API 调用获取市场数据、管理账户信息以及下单和撤单。

⚠️ 安全与防护

此服务可以使用真实资金进行真实交易。配置前请阅读以下内容：

• 默认禁用交易。 如果未明确设置 TRADING_ENABLED=true，修改状态的工具（place_order、cancel_order、amend_order、cancel_all_orders、set_trading_stop、set_margin_mode、set_leverage）会返回错误。
• 请先使用测试网。 尝试时请设置 TESTNET=true。如需完全只读设置，可同时设为 TRADING_ENABLED=false；也可设置 READONLY_MODE=true，无论其他设置如何，都会阻止所有修改状态的工具。
• 订单规模设有上限。 MAX_ORDER_SIZE_USDT（默认值为 100）会限制订单的预估名义价值，以防误下大额订单。
• 绝不会记录或公开 API 密钥。 没有工具会返回您的密钥；日志仅会报告密钥是否存在。
• 切勿提交您的 API 密钥。 仅通过环境变量提供密钥。

安装

需要 Python 3.12+。此项目使用 uv。

git clone https://github.com/dlwjdtn535/mcp-bybit-server.git
cd mcp-bybit-server
uv sync
uv run mcp-bybit-server   # runs the MCP server over stdio

安装后，mcp-bybit-server 命令是下方 MCP 客户端配置中使用的入口点。

通过 Smithery 安装

如需通过 Smithery 自动为 Claude Desktop 安装此 Bybit API 接口服务：

npx -y @smithery/cli install @dlwjdtn535/mcp-bybit-server --client claude

配置（Claude Desktop、Cline、Roo Code 等）

将以下配置之一添加到您的 MCP 设置文件中（例如 claude_desktop_config.json / mcp_settings.json）。

使用 uv（在克隆的仓库中运行）：

{
  "mcpServers": {
    "bybit": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/mcp-bybit-server",
        "mcp-bybit-server"
      ],
      "env": {
        "ACCESS_KEY": "YOUR_BYBIT_API_KEY",
        "SECRET_KEY": "YOUR_BYBIT_SECRET_KEY",
        "TESTNET": "true",
        "TRADING_ENABLED": "false"
      }
    }
  }
}

在 Windows 上，请使用带双反斜杠的绝对路径（例如 C:\\Users\\YOUR_USERNAME\\mcp-bybit-server）。

使用 Docker：

首先拉取镜像：docker pull dlwjdtn535/mcp-bybit-server:latest

{
  "mcpServers": {
    "bybit-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e", "ACCESS_KEY=YOUR_BYBIT_API_KEY",
        "-e", "SECRET_KEY=YOUR_BYBIT_SECRET_KEY",
        "-e", "TESTNET=true",
        "-e", "TRADING_ENABLED=false",
        "-e", "MAX_ORDER_SIZE_USDT=100",
        "dlwjdtn535/mcp-bybit-server:latest"
      ]
    }
  }
}

注意：NPX 和 Docker 均应始终使用 @latest 或特定版本标签，以确保使用的是预期版本。

环境变量

变量	必需	默认值	描述
ACCESS_KEY	是	–	Bybit API 密钥。
SECRET_KEY	是	–	Bybit API 密钥密码。
MEMBER_ID	否	–	Bybit 会员 ID（可选）。
TESTNET	否	false	为 true 时使用 Bybit 测试网。
TRADING_ENABLED	否	false	必须设为 true 才允许使用任何修改状态／交易工具。
READONLY_MODE	否	false	为 true 时阻止所有修改状态的工具（优先级高于 TRADING_ENABLED）。
MAX_ORDER_SIZE_USDT	否	100	限制单笔订单的预估名义价值（USDT）。
RESPONSE_VERBOSITY	否	normal	minimal 会将 get_tickers／get_positions 响应精简为核心字段以节省令牌；normal／full 会返回完整载荷。

工具 🛠️

市场数据

• get_orderbook — 订单簿（category、symbol、limit?）。
• get_kline — K 线（category、symbol、interval、start?、end?、limit?）。
• get_tickers — 行情信息（category、symbol）。
• get_public_trade_history — 近期公开交易（category、symbol、limit?）。
• get_instruments_info — 合约元数据 / 限制（category、symbol、status?、baseCoin?）。
• get_funding_rate_history — 永续合约资金费率历史记录（category、symbol、startTime?、endTime?、limit?）。
• get_open_interest — 一段时间内的未平仓合约数（category、symbol、intervalTime?、...）。
• get_fee_rate — 挂单 / 吃单费率（category、symbol?、baseCoin?）。
• get_server_time — Bybit 服务端时间。
• market_snapshot — 综合市场视图（订单簿 + 行情 + K 线 + 合约信息 + 近期交易；期货还包括资金费率和未平仓合约数），通过单次调用获取。

账户

• get_wallet_balance — 余额（accountType、coin?）。
• get_positions — 未平仓仓位（category、symbol?）。
• get_order_history — 历史订单。
• get_open_orders — 当前未结订单。
• get_api_key_information — API 密钥详情。

交易（会修改状态 — 需要 TRADING_ENABLED=true）

• validate_order — 下单前验证；不会下单。不受交易标志限制。
• place_order — 下单；支持使用 dry_run=true 进行验证而不实际下单。
• amend_order — 原地修改现有订单。
• cancel_order — 取消单个订单。
• cancel_all_orders — 取消所有未结订单（可选指定范围）。
• set_trading_stop — 设置止盈 / 止损 / 跟踪止损。
• set_margin_mode — 设置逐仓 / 全仓模式。
• set_leverage — 设置期货交易对的杠杆。

（详细的参数说明和示例请参阅代码中的函数文档字符串。）

API 密钥设置

要使用此 Bybit API 接口，请在 Bybit 创建 API 密钥：

1. 登录 Bybit 账户。
2. 前往 API 管理。
3. 创建新的 API 密钥。
4. 重要安全设置：
   • 尽可能启用 IP 限制，并且仅添加服务器运行所在的 IP 地址。
   • 切勿分享 API 密钥，或将其暴露在公开代码仓库中。
   • 建议的权限：
     • 读取（必需）
     • 交易（仅在启用订单执行时必需）
     • 钱包（查询余额时必需）

开发

uv sync --group dev   # install dev dependencies (pytest, ruff)
uv run ruff check .   # lint
uv run pytest -q      # run the unit test suite (no live API calls)

CI（GitHub Actions）会在每次推送或提交 PR 时运行 lint 和测试；推送到 main 时会自动构建并发布 Docker 镜像。

赞助与捐赠

如果你觉得这个项目有帮助，并希望支持其开发：

请我喝杯咖啡

推荐计划

你也可以通过我们的推荐链接注册 Bybit，以支持此项目：

• 我的 Bybit 推荐链接
• 推荐码：J1O4JK

你的支持有助于维护和改进此项目。谢谢！🙏

联系与支持

如有其他疑问或需要支持，请联系：

• 电子邮件：[email protected]

欢迎提出问题和反馈！

许可证

MIT 许可证