使用说明
Bybit MCP服务器
一个功能强大的服务器,将Bybit的交易API与机器认知协议(MCP)连接起来,以实现人工智能辅助的加密货币交易。
概述
Bybit MCP服务器是Bybit交易平台和使用机器认知协议(MCP)的AI系统之间的桥梁。它为市场分析、技术指标计算和自动化交易操作提供了一套强大的工具。
特性
- 实时市场数据:获取当前价格、市场深度和历史数据
- 高级技术分析:计算RSI、MACD、ATR等指标
- 多时间段分析:分析多个时间范围内的市场趋势
- 自动交易:以编程方式下达、修改和取消订单
- 风险管理:基于波动性的头寸规模建议
- 支撑/阻力检测:确定关键价格水平,以获得更好的进入/退出点
- Docker支持:使用Docker和Docker compose轻松部署
需求
- Python 3.12+
- Bybit API凭据
- 有效的互联网连接
安装
使用Virtualenv进行本地安装
-
克隆存储库:
git clone https://github.com/andrefigueira93/bybit-mcp-server.git cd bybit-mcp-server -
创建并激活虚拟环境:
uv venv source .venv/bin/activate -
安装依赖项:
uv pip install -e . -
创建一个
.env使用API凭据提交文件:BYBIT_API_KEY=your_api_key BYBIT_API_SECRET=your_api_secret BYBIT_TESTNET=True # Set to False for production
使用Docker
-
克隆存储库:
git clone https://github.com/andrefigueira93/bybit-mcp-server.git cd bybit-mcp-server -
创建一个
.env使用API凭据(如上所述)提交 -
使用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密钥 | 无(必需) |
BYBIT_API_SECRET |
Bybit的API机密 | 无(必需) |
BYBIT_TESTNET |
是使用测试网(True)还是主网(False) | True |
贡献
欢迎投稿!如果您想改进Bybit MCP服务器,请:
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。
免责声明
此软件仅用于教育目的。使用风险自负。交易加密货币涉及重大风险,您可能会亏损。过去的表现并不预示未来的结果。
