MCP Bybit API 接口

Bybit MCP (模型上下文协议) 服务器。提供了一个方便的接口，使用MCP工具与Bybit API进行交互。允许通过API调用获取市场数据、管理账户信息以及下单/取消订单。

使用方法

通过 Smithery 安装

要通过 Smithery 自动安装此 Bybit API 接口服务器到 Claude Desktop：

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"
      ]
    }
  }
}

注意：为了确保您使用的是预期版本，请始终对 NPX 和 Docker 使用 @latest 或特定版本标签。

工具 🛠️

此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 (可选)
    • 返回: 交易品种详情。

(有关详细的参数描述和示例，请参阅代码中的函数文档字符串。)

环境变量

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

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 来支持此项目：

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

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

联系与支持

对于额外的咨询或支持，请联系：

• 电子邮件: dlwjdtn5624@naver.com

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

许可证

MIT 许可证