AI导哈

Bybit API接口

Bybit MCP服务器提供了一种便捷的方式通过MCP工具与Bybit API进行交互，支持获取市场数据、管理账户信息以及下单/取消订单等功能。

  • by dlwjdtn535
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 dlwjdtn535/mcp-bybit-trader

使用说明

MCP Bybit API接口

Bybit MCP（模型上下文协议）服务器。提供一个使用MCP工具与Bybit API交互的方便界面。允许通过包装为工具的API调用获取市场数据、管理账户信息和下订单/取消订单。

用法

通过Smithery安装

通过以下方式为Claude Desktop自动安装此Bybit API接口服务器 史密瑟里:

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

与Claude、Roo Code、Cline等一起使用。

将以下配置添加到MCP设置文件中（例如。， mcp_settings.json): 在Windows中使用uv：

{
  "mcpServers": {
    "mcp-server-demo": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\mcp-server-demo\\src",
        "server.py"
      ],
      "env": {
          "ACCESS_KEY": "{ACCESS_KEY}",
          "SECRET_KEY": "{ACCESS_KEY}"
        }
    }
    // ... other servers might be here ...
  }
}

（记得替换YOUR_USERNAME并使用双反斜杠\）

在macOS上使用uv：

{
  "mcpServers": {
    "mcp-server-demo": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/usr/local/bin/mcp-server-demo/src",
        "server.py"
      ],
      "env": {
        "ACCESS_KEY": "{ACCESS_KEY}",
        "SECRET_KEY": "{ACCESS_KEY}"
      }
    }
    // ... other servers might be here ...
  }
}

（如果使用~/bin，请替换YOUR_USERNAME）

在Linux中使用uv：

{
  "mcpServers": {
    "mcp-server-demo": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/home/YOUR_USERNAME/bin/mcp-server-demo/src",
        "server.py"
      ],
      "env": {
        "ACCESS_KEY": "{ACCESS_KEY}",
        "SECRET_KEY": "{ACCESS_KEY}"
      }
    }
    // ... other servers might be here ...
  }
}

使用Docker（需要Docker）

请确保您已先提取图像： docker pull dlwjdtn535/mcp-bybit-server:latest

{
  "mcpServers": {
    "bybit-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i", 
        "--rm",
        "--init",
        "-e", "ACCESS_KEY={ACCESS_KEY}",
        "-e", "SECRET_KEY={SECRET_KEY}",
        "dlwjdtn535/mcp-bybit-server:latest"
      ]
    }
  }
}

将Docker与.env一起使用（需要Docker）

请确保您已先提取图像： docker pull dlwjdtn535/mcp-bybit-server:latest

{
  "mcpServers": {
    "bybit-server-docker": {
      "command": "/bin/sh",
      "args": [
        "-c",
        "source .env && docker run -i --rm --init -e ACCESS_KEY=$BYBIT_API_KEY -e SECRET_KEY=$BYBIT_API_SECRET -e TESTNET=true dlwjdtn535/mcp-bybit-server:latest"
      ]
    }
  }
}

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

工具🛠️

此MCP服务器为与Bybit API交互提供了以下工具：

  1. get_orderbook：获取订单簿信息。
    • 输入： category, symbol, limit （可选）
    • 退货：订单详情。
  2. get_kline：获取K线（烛台）数据。
    • 输入： category, symbol, interval, start （可选）， end （可选）， limit （可选）
    • 返回：烛台数据。
  3. get_tickers：获取加密货币股票信息。
    • 输入： category, symbol
    • 返回：票务信息。
  4. get_wallet_balance：获取账户余额。
    • 输入： accountType, coin （可选）
    • 返回：余额信息。
  5. get_positions：获取位置信息。
    • 输入： category, symbol （可选）
    • 返回：位置信息。
  6. place_order：下达限价单或市价单。
    • 输入： category, symbol, side, orderType, qty, price （可选限制）， positionIdx （期货可选）和其他可选参数（例如。， timeInForce, takeProfit, stopLoss).
    • 退货：订单确认。
  7. cancel_order：取消现有订单。
    • 输入： category, symbol, orderId （可选）， orderLinkId （可选）
    • 退货：取消确认。
  8. get_order_history：获取历史订单详细信息。
    • 输入： category, symbol （可选）， orderId （可选）， limit （可选）等。
    • 退货：订单历史记录。
  9. get_open_orders：获取当前未结订单。
    • 输入： category, symbol （可选）， limit （可选）等。
    • 退货：未结订单详细信息。
  10. set_trading_stop：为头寸设置止盈、止损或尾随止损。
    • 输入： category, symbol, takeProfit （可选）， stopLoss （可选）， trailingStop （可选）， positionIdx （可选）
    • 返回：设置确认。
  11. set_margin_mode：设置边距模式（孤立或交叉）。
    • 输入： category, symbol, tradeMode, buyLeverage, sellLeverage
    • 返回：设置确认。
  12. get_api_key_information：获取有关当前API密钥的信息。
    • 输入：无
    • 返回：API密钥详细信息。
  13. get_instruments_info：获取交易工具（交易品种）的详细信息。
    • 输入： category, symbol, status （可选）， baseCoin （可选）
    • 返回：仪器详细信息。

（有关详细的参数说明和示例，请参阅代码中的函数docstring。）

环境变量

在运行服务器之前，您 必须 设置以下环境变量：

ACCESS_KEY=YOUR_BYBIT_API_KEY
SECRET_KEY=YOUR_BYBIT_SECRET_KEY
TESTNET=false # Optional: set to true for testnet

API密钥设置

若要使用此Bybit API接口，您需要从Bybit创建一个API密钥。请执行以下重要步骤：

  1. 转到Bybit并登录您的帐户。
  2. 导航到API管理。
  3. 创建一个新的API密钥。
  4. 重要安全设置：
    • 如果可能，启用IP限制。
    • 只添加服务器运行的IP地址（本地PC IP、服务器IP或Docker容器的外部IP）。
    • 永远不要共享API密钥或在公共存储库中公开它们。
    • 建议权限：
      • 阅读（必填）
      • 交易（订单执行所需）
      • 钱包（余额查询所需）

赞助与捐赠

如果你觉得这个项目很有帮助，并想支持它的发展，你可以通过以下方式做出贡献：

给我买杯咖啡

推荐计划

您还可以通过使用我们的推荐链接注册Bybit来支持此项目：

您的支持有助于维护和改进此项目。非常感谢。 🙏

联系与支持

如需更多咨询或支持，请联系：

  • 电子邮件：dlwjdtn5624@naver.com

我们欢迎您的问题和反馈！

许可证

MIT许可证

相关 MCP