项目介绍
技术文档摘要
MCP Bybit API 接口
Bybit MCP（模型上下文协议）服务器。提供了一个方便的接口，使用MCP工具与Bybit API进行交互。允许通过API调用获取市场数据、管理账户信息以及下单或取消订单。
<a href="https://glama.ai/mcp/servers/@dlwjdtn535/mcp-bybit-server"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=609785274,3606280050&fm=3081&app=3_081&f=PNG?w=760&h=400" alt="Bybit Server MCP 服务器" /> </a>使用方法
通过 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}"
}
}
// ... 其他服务器可能在这里 ...
}
}
（记得替换 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}"
}
}
// ... 其他服务器可能在这里 ...
}
}
（如果使用 ~/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}"
}
}
// ... 其他服务器可能在这里 ...
}
}
使用 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 进行交互：
get_orderbook：获取订单簿信息。- 输入参数：
category，symbol，limit（可选） - 返回值：订单簿详情。
- 输入参数：
get_kline：获取K线（蜡烛图）数据。- 输入参数：
category，symbol，interval，start（可选），end（可选），limit（可选） - 返回值：蜡烛图数据。
- 输入参数：
get_tickers：获取加密货币行情信息。- 输入参数：
category，symbol - 返回值：行情信息。
- 输入参数：
get_wallet_balance：获取账户余额。- 输入参数：
accountType，coin（可选） - 返回值：余额信息。
- 输入参数：
get_positions：获取持仓信息。- 输入参数：
category，symbol（可选） - 返回值：持仓信息。
- 输入参数：
place_order：下单（限价单或市价单）。- 输入参数：
category，symbol，side，orderType，qty，price（限价单时可选），positionIdx（期货时可选），以及其他可选参数（如timeInForce，takeProfit，stopLoss）。 - 返回值：下单确认。
- 输入参数：
cancel_order：取消现有订单。- 输入参数：
category，symbol，orderId（可选），orderLinkId（可选） - 返回值：取消确认。
- 输入参数：
get_order_history：获取历史订单详情。- 输入参数：
category，symbol（可选），orderId（可选），limit（可选）等。 - 返回值：订单历史。
- 输入参数：
get_open_orders：获取当前未平仓订单。- 输入参数：
category，symbol（可选），limit（可选）等。 - 返回值：未平仓订单详情。
- 输入参数：
set_trading_stop：设置止盈、止损或追踪止损。- 输入参数：
category，symbol，takeProfit（可选），stopLoss（可选），trailingStop（可选），positionIdx（可选） - 返回值：设置确认。
- 输入参数：
set_margin_mode：设置保证金模式（隔离或全仓）。- 输入参数：
category，symbol，tradeMode，buyLeverage，sellLeverage - 返回值：设置确认。
- 输入参数：
get_api_key_information：获取当前 API 密钥的信息。- 输入参数：无
- 返回值：API 密钥详情。
get_instruments_info：获取交易工具（符号）的详细信息。- 输入参数：
category，symbol，status（可选），baseCoin（可选） - 返回值：工具详情。
- 输入参数：
（参阅代码中的函数说明字符串以获得详细的参数描述和示例。）
环境变量
在运行服务器之前，您必须设置以下环境变量：
ACCESS_KEY=YOUR_BYBIT_API_KEY
SECRET_KEY=YOUR_BYBIT_SECRET_KEY
TESTNET=false # 可选：设置为 true 用于测试网
API 密钥设置
要使用此 Bybit API 接口，您需要从 Bybit 创建一个 API 密钥。请遵循以下重要步骤：
- 登录到 Bybit 账户。
- 导航至 API 管理。
- 创建一个新的 API 密钥。
- 重要安全设置：
- 如果可能，请启用 IP 限制。
- 仅添加服务器运行的 IP 地址（您的本地 PC IP、服务器 IP 或 Docker 容器的外部 IP）。
- 切勿共享您的 API 密钥或将其暴露在公共存储库中。
- 建议权限：
- 读取（必需）
- 交易（执行订单所需）
- 钱包（检查余额所需）
赞助与捐赠
如果您发现这个项目有用并希望支持其开发，您可以以下列方式贡献：
请我喝杯咖啡
推荐计划
您还可以通过使用我们的推荐链接注册 Bybit 来支持此项目：
- 我的 Bybit 推荐链接
- 推荐码：J1O4JK
您的支持有助于维护和改进此项目。谢谢！🙏
联系与支持
如有其他问题或需要支持，请联系：
我们欢迎您的提问和反馈！
许可证
MIT 许可证