项目简介

Bybit MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 应用提供与 Bybit 加密货币交易所进行交互的能力。它通过标准化的 MCP 协议，将 Bybit API 的功能封装成一系列易于 LLM 调用的工具，使得 LLM 能够方便地获取市场数据、管理交易账户、执行交易操作等。

主要功能点

市场数据获取: 提供获取 Bybit 交易所各类市场数据的功能，包括：
- 订单簿 (Orderbook)
- K线数据 (Kline)
- 市场行情 (Tickers)
- 交易对信息 (Instruments Info)
账户信息查询: 支持查询 Bybit 账户的资金余额 (Wallet Balance)、持仓信息 (Positions)、API 密钥信息 (API Key Information) 等。
交易功能: 提供完整的交易功能，允许 LLM 应用执行以下操作：
- 下单 (Place Order)：支持市价单、限价单，以及各种高级订单参数。
- 撤单 (Cancel Order)：取消指定订单。
- 查询订单历史 (Order History)：获取历史订单记录。
- 查询当前委托 (Open Orders)：获取当前未成交的订单。
- 设置止盈止损 (Set Trading Stop)：为仓位设置止盈、止损或追踪止损。
- 设置杠杆模式 (Set Margin Mode)：设置逐仓或全仓杠杆模式。

安装步骤

安装 Smithery CLI (如果选择 Smithery 安装方式): 如果您希望通过 Smithery 自动安装，请确保已安装 Node.js 和 npm，并执行以下命令安装 Smithery CLI：
```
npm install -g @smithery/cli
```
安装 Docker (如果选择 Docker 部署方式): 如果您选择使用 Docker 部署，请确保已安装 Docker 和 Docker Compose。
获取 API 密钥:
- 登录 Bybit 官网，进入 API 管理页面。
- 创建新的 API 密钥。
- 务必配置 API 密钥的安全设置：
  - 启用 IP 限制，并仅添加运行 MCP 服务器的 IP 地址。
  - 授予 API 密钥 读取 (Read)、交易 (Trade) 和 钱包 (Wallet) 权限。
- 记录您的 ACCESS_KEY 和 SECRET_KEY。

配置环境变量: 创建或编辑 '.env' 文件（或直接在运行环境中设置），添加以下环境变量，替换为您自己的 API 密钥：

ACCESS_KEY=YOUR_BYBIT_API_KEY
SECRET_KEY=YOUR_BYBIT_SECRET_KEY
TESTNET=false  # 如果使用 Bybit 测试网，请设置为 true

选择安装方式并安装服务器:

通过 Smithery 安装 (推荐 Claude Desktop 用户): 执行以下命令，将自动安装并配置 Bybit MCP Server：

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

使用 Docker 部署: 首先拉取 Docker 镜像：
```
docker pull dlwjdtn535/mcp-bybit-server:latest
```
然后，您可以手动运行 Docker 镜像，或者使用 Docker Compose 进行更方便的管理。

服务器配置 (MCP客户端)

MCP 服务器配置信息通常在 MCP 客户端（例如 Claude, Roo Code, Cline 等）的 'mcp_settings.json' 文件中进行配置。以下是针对 Bybit MCP Server 的配置示例，您可以根据您的部署方式选择相应的配置：

Docker 部署配置示例:

{
  "mcpServers": {
    "bybit-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e", "ACCESS_KEY={YOUR_BYBIT_API_KEY}",  // 替换为您的 Bybit API ACCESS_KEY
        "-e", "SECRET_KEY={YOUR_BYBIT_SECRET_KEY}", // 替换为您的 Bybit API SECRET_KEY
        "dlwjdtn535/mcp-bybit-server:latest"
      ]
    }
  }
}

配置参数说明:

'"bybit-server-docker"': 服务器名称，您可以自定义。
'"command": "docker"': 指定启动服务器的命令为 'docker'。
'"args": [...]': 启动 'docker run' 命令所需的参数列表。
- '"-i"': 保持标准输入 (stdin) 打开。
- '"--rm"': 容器退出后自动删除。
- '"--init"': 在容器内运行初始化进程。
- '"-e", "ACCESS_KEY={YOUR_BYBIT_API_KEY}"': 设置环境变量 'ACCESS_KEY'，请替换 '{YOUR_BYBIT_API_KEY}' 为您的实际 API ACCESS_KEY。
- '"-e", "SECRET_KEY={YOUR_BYBIT_SECRET_KEY}"': 设置环境变量 'SECRET_KEY'，请替换 '{YOUR_BYBIT_SECRET_KEY}' 为您的实际 API SECRET_KEY。
- '"dlwjdtn535/mcp-bybit-server:latest"': Docker 镜像名称和标签。

注意:

请务必将 '{YOUR_BYBIT_API_KEY}' 和 '{YOUR_BYBIT_SECRET_KEY}' 替换为您在 Bybit 官网申请的 API 密钥。
如果您选择其他部署方式（例如直接运行 'server.py'），则需要根据实际情况修改 'command' 和 'args' 配置。

基本使用方法

配置完成后，在您的 MCP 客户端中，您可以使用自然语言指令调用 Bybit MCP Server 提供的工具。例如，您可以向 Claude 这样的 LLM 客户端发送指令：

"获取 BTCUSDT 现货市场的订单簿"
"查询我的 USDT 账户余额"
"买入 0.1 个 BTCUSDT 现货"

LLM 客户端会解析您的指令，并调用 Bybit MCP Server 提供的相应工具来执行操作并返回结果。您可以在 'src/server.py' 文件中查看每个工具的详细参数和使用示例。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP客户端)

基本使用方法

信息