Bybit MCP Server

Bybit MCP 服务

一款功能强大的服务，将 Bybit 的交易 API 与 Machine Cognition Protocol（MCP）连接起来，以支持 AI 辅助加密货币交易。

概述

Bybit MCP 服务是 Bybit 交易平台与使用 Machine Cognition Protocol（MCP）的 AI 系统之间的桥梁。它提供一系列功能强大的工具，用于市场分析、技术指标计算和自动化交易操作。

功能

• 实时市场数据：访问当前价格、市场深度和历史数据
• 高级技术分析：计算 RSI、MACD、ATR 等指标
• 多时间周期分析：跨多个时间周期分析市场趋势
• 自动化交易：以编程方式下单、修改和取消订单
• 风险管理：根据波动率提供仓位规模建议
• 支撑位／阻力位检测：识别关键价格水平，以改善入场／出场点位
• Docker 支持：使用 Docker 和 docker-compose 轻松部署

要求

• Python 3.12+
• Bybit API 凭据
• 有效的互联网连接

安装

使用 Virtualenv 本地安装

1. 克隆仓库：

   git clone https://github.com/andrefigueira93/bybit-mcp-server.git
   cd bybit-mcp-server
   

2. 创建并激活虚拟环境：

   uv venv
   source .venv/bin/activate
   

3. 安装依赖项：

   uv pip install -e .
   

4. 创建 .env 文件并填入 API 凭据：

   BYBIT_API_KEY=your_api_key
   BYBIT_API_SECRET=your_api_secret
   BYBIT_TESTNET=True  # Set to False for production
   

使用 Docker

1. 克隆仓库：

   git clone https://github.com/andrefigueira93/bybit-mcp-server.git
   cd bybit-mcp-server
   

2. 创建 .env 文件并填入 API 凭据（同上）

3. 使用 Docker Compose 构建并运行：

   docker-compose build
   docker-compose up -d
   

使用方法

启动服务

要在本地运行服务：

mcp run main.py -t sse

服务默认在端口 8000 上启动。使用 Docker 时，服务通过端口 80 对外提供。

可用工具

服务提供以下工具：

工具名称	描述
get_balance	获取当前钱包余额
get_ticker	获取某个交易对的当前价格、成交量及其他数据
get_klines	获取用于分析的历史蜡烛图数据
analyze_market	对某个交易对进行全面的技术分析
analyze_multi_timeframe	跨多个时间周期进行分析
place_order	下达买入／卖出订单，可选择设置止盈／止损
cancel_order	取消有效订单
get_active_orders	列出所有有效订单
get_active_positions	列出所有未平仓仓位

使用 MCP 的示例

连接到兼容 MCP 的客户端后：

# Example of using the MCP client to get a market analysis
analysis = mcp_client.call("analyze_market", symbol="BTCUSDT", intervalo="60")
print(analysis)

# Example of placing a market order
order = mcp_client.call("place_order",
                       symbol="BTCUSDT",
                       side="Buy",
                       order_type="Market",
                       qty=0.001,
                       stop_loss=25000)
print(order)

项目结构

bybit-mcp-server/
├── main.py            # Main server file with MCP tools
├── pyproject.toml     # Project dependencies and metadata
├── Dockerfile         # Docker configuration
├── docker-compose.yml # Docker Compose configuration
├── .env               # Environment variables (create this yourself)
└── README.md          # This file

环境变量

变量	描述	默认值
BYBIT_API_KEY	Bybit 的 API 密钥	None（必填）
BYBIT_API_SECRET	Bybit 的 API 密钥	None（必填）
BYBIT_TESTNET	是否使用测试网（True）或主网（False）	True

参与贡献

欢迎贡献！如果你希望改进 Bybit MCP 服务，请：

1. Fork 仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

免责声明

本软件仅供教育用途。使用风险自负。加密货币交易风险重大，您可能会蒙受损失。过往表现不代表未来结果。