MCP Bybit API Interface

MCP Bybit API Interface

site icon
2025.04.11 2
Python加密货币交易API接口自动化交易金融服务
MCP Bybit API Interface 是一个基于 MCP(Model Context Protocol)的服务器,提供与 Bybit API 交互的便捷接口。它允许通过 API 调用获取市场数据、管理账户信息以及下单/取消订单等功能。该服务适用于需要自动化交易、市场数据分析或账户管理的场景。
View on GitHub

Overview

基本能力

产品定位

MCP Bybit API Interface 是一个专门为 Bybit 交易平台设计的 API 接口服务,旨在通过 MCP 工具简化与 Bybit API 的交互过程。

核心功能

  1. 获取市场数据:包括订单簿信息、K线数据、加密货币行情等。
  2. 账户管理:查询钱包余额、持仓信息等。
  3. 交易功能:下单、取消订单、设置止盈止损等。
  4. 账户设置:调整保证金模式、杠杆等。
  5. API 管理:获取 API 密钥信息等。

适用场景

  1. 自动化交易:通过程序自动执行交易策略。
  2. 市场分析:获取实时市场数据进行技术分析。
  3. 账户监控:实时监控账户余额和持仓情况。
  4. 风险管理:设置止盈止损等风险控制措施。

工具列表

  1. get_orderbook: 获取订单簿信息。
  2. get_kline: 获取K线数据。
  3. get_tickers: 获取加密货币行情。
  4. get_wallet_balance: 查询钱包余额。
  5. get_positions: 查询持仓信息。
  6. place_order: 下单。
  7. cancel_order: 取消订单。
  8. get_order_history: 获取订单历史。
  9. get_open_orders: 获取当前未成交订单。
  10. set_trading_stop: 设置止盈止损。
  11. set_margin_mode: 设置保证金模式。
  12. get_api_key_information: 获取API密钥信息。
  13. get_instruments_info: 获取交易品种信息。

常见问题解答

  1. API密钥设置:需要在Bybit平台创建API密钥,并设置适当的权限和IP限制。
  2. 环境变量:必须设置ACCESS_KEYSECRET_KEY环境变量才能运行服务。
  3. 测试网络:可以通过设置TESTNET=true来使用Bybit的测试网络。

使用教程

使用依赖

  1. 需要安装Node.js以使用Smithery安装工具。
  2. 如需使用Docker方式运行,需要安装Docker。

安装教程

通过Smithery安装

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

通过Docker安装

  1. 拉取镜像:
docker pull dlwjdtn535/mcp-bybit-server:latest
  1. 运行容器(需替换{ACCESS_KEY}{SECRET_KEY}):
docker run -i --rm --init -e ACCESS_KEY={ACCESS_KEY} -e SECRET_KEY={SECRET_KEY} dlwjdtn535/mcp-bybit-server:latest

调试方式

  1. 确保环境变量ACCESS_KEYSECRET_KEY已正确设置。
  2. 检查API密钥是否具有足够的权限。
  3. 如需使用测试网络,设置TESTNET=true环境变量。
  4. 可以通过调用简单的工具如get_tickers来测试服务是否正常运行。

环境变量设置

在运行服务器前,必须设置以下环境变量:

ACCESS_KEY=YOUR_BYBIT_API_KEY
SECRET_KEY=YOUR_BYBIT_SECRET_KEY
TESTNET=false # 可选:设置为true使用测试网络

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。