AI导哈

Bybit MCP服务器

Bybit MCP服务器是一个为AI助手设计的工具，使它们能够通过自然语言直接与Bybit加密货币交易所交互，执行交易、管理投资组合、分析市场和自动化策略。

  • by JohnnyWic
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 JohnnyWic/bybit-mcp

使用说明

🟡 Bybit MCP服务器

适用于Bybit 247工具的最全面的MCP服务器，涵盖整个Bybit V5 API

快速开始 • 特性 • 配置 • 工具参考 • 故障排除 • 贡献

🎯 概述

Bybit MCP服务器支持以下AI助手 克劳德, 光标, ChatGPT，以及其他兼容MCP的客户端，直接与Bybit加密货币交易所进行交互。通过自然语言执行交易、管理投资组合、分析市场和自动化策略。

为什么选择Bybit MCP？

  • 🔥 全覆盖 -247个工具，跨越每个Bybit V5 API端点
  • 🔐 设计安全 -API凭据永远不会离开您的计算机
  • 👁️ 只读模式 -在没有任何API密钥的情况下使用所有市场工具
  • 📡 三重运输 --STDIO、SSE和流式HTTP
  • 🔌 通用兼容性 --适用于Claude Desktop、Cursor、ChatGPT和任何MCP客户端
  • ⚡ 零配置启动 --只是 uv run bybit.py 走吧

✨ 特性

📈 交易与市场

  • 现货交易 --市价单和限价单、批量操作
  • 衍生品 --线性和逆垂线
  • 订单管理 --修改、取消、批处理、DCP
  • 市场数据 --Klines、订单簿、股票行情、资金利率
  • 未平仓合约 --长/短比率，ADL警报

💰 赚取和贷款

  • 简单赚钱 --质押、赎回、收益跟踪
  • 加密货币贷款 --新旧（固定+灵活）
  • 杠杆代币 --订阅并兑换
  • 现货保证金 --交叉保证金交易
  • OTC贷款 --机构贷款管理

🏦 账户和资产

  • 钱包 --存款、取款、转账
  • 多账户 --子账户、普遍转账
  • 资产转换 --加密货币到加密货币、小额余额、法定货币
  • 边距模式 --交叉、孤立、投资组合利润
  • 风险管理 --MMP、杠杆、TP/SL

🛠️ 高级

  • 价差交易 --点差工具和订单
  • 大宗交易（RFQ） --询价工作流程
  • 经纪人 --收入、利率限制、代金券
  • 策略 --内置套利检测
  • 公告 --交换新闻和系统状态

🚀 快速开始

方法1：让AI安装（推荐）

只需告诉你的AI助手：

“帮助我从以下位置安装Bybit MCP服务器https://github.com/JohnnyWic/bybit-mcp"

你的AI将克隆仓库，安装依赖项，并自动配置所有内容。适用于Claude Code、Cursor和其他MCP兼容客户端。

方法2：手动设置

1.安装

git clone https://github.com/JohnnyWic/bybit-mcp.git
cd bybit-mcp
uv sync

需要 Python≥3.13 和 紫外线.

2.添加到您的MCP客户端

将以下内容添加到MCP配置文件中：

客户端 配置文件
克劳德桌面 claude_desktop_config.json
光标 ~/.cursor/mcp.json
克劳德代码 运行 claude mcp add （见下文）

JSON配置（克劳德桌面/光标）：

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/bybit-mcp", "run", "bybit.py"]
    }
  }
}

克劳德代码CLI：

claude mcp add bybit-mcp -- uv --directory /path/to/bybit-mcp run bybit.py

3.配置API密钥（可选）

创建一个 .env 项目根目录中的文件：

cp .env.example .env

BYBIT_API_KEY=your_api_key_here
BYBIT_SECRET_KEY=your_secret_key_here
BYBIT_TESTNET=false

或者在MCP配置中内联传递凭据：

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/bybit-mcp", "run", "bybit.py",
        "--bybit-api-key", "YOUR_API_KEY",
        "--bybit-secret-key", "YOUR_SECRET_KEY"
      ]
    }
  }
}

💡 没有API密钥？ 没问题！所有23个市场数据工具都可以在没有身份验证的情况下工作。

🔒 安全说明： 永远不要承诺你的 .env 文件。它已经在里面了 .gitignore.

运输方式

uv run bybit.py                                        # STDIO (default)
uv run bybit.py --transport sse --port 8000             # SSE
uv run bybit.py --transport streamable-http --port 8000 # Streamable HTTP

💬 使用示例

查看市场价格

"What's the current price of BTC?"

进行交易

"Buy 0.01 BTC at market price on spot"

分析资金利率

"Show me the funding rate history for ETHUSDT over the last 24 hours"

管理职位

"What are my open positions? Set a stop loss at 95000 for my BTCUSDT long"

投资组合概述

"Show my unified account balance and all open orders"

📊 可用工具（246）

模块 工具 说明
市场 23 价格、价格、订单、融资利率、未平仓合约、股票代码 （不需要API密钥）
贸易 15 市价单/限价单、修改、取消、批量操作、DCP
账户 25 余额、费率、保证金模式、抵押品、MMP、交易日志
位置 11 头寸、杠杆、TP/SL、自动保证金、移动头寸
资产 41 存款、取款、转账、转换、法定货币、地址管理
借贷 39 加密货币贷款——传统+新（固定和灵活）
用户 15 子账户、API密钥管理、附属机构
询价单 15 大宗交易——创建/取消询价、报价、执行
现货保证金 12 现货保证金交易、借款、还款、抵押品
传播 11 点差工具、订单簿、交易
经纪人 10 经纪人收入、利率限制、代金券
非处方药 7 机构场外贷款
预升级 6 升级前历史数据查询
赚取 6 质押、赎回、收益跟踪
杠杆代币 5 杠杆代币认购/赎回
公告 2 交易所公告、系统状态
策略 2 内置套利对检测

总计：246个工具

📋 View all tool names 
uv run python -c "
import src.tools
from src import mcp
for name in sorted(mcp._tool_manager._tools):
    print(name)
"

🏗️ 项目结构

bybit-mcp/
├── bybit.py                    # Entry point (backward compatible)
├── src/
│   ├── __init__.py             # Shared FastMCP instance
│   ├── main.py                 # CLI: dotenv + argparse + logging + mcp.run()
│   ├── client.py               # Config singleton + HMAC signing + HTTP methods
│   └── tools/
│       ├── __init__.py         # Auto-imports all tool modules
│       ├── market.py           # 23 tools — public market data
│       ├── trade.py            # 15 tools — order management
│       ├── account.py          # 25 tools — account operations
│       ├── position.py         # 11 tools — position management
│       ├── asset.py            # 41 tools — wallet & transfers
│       ├── lending.py          # 39 tools — crypto loans
│       ├── earn.py             #  6 tools — staking & yield
│       ├── leveraged_token.py  #  5 tools — leveraged tokens
│       ├── spot_margin.py      # 12 tools — spot margin
│       ├── user.py             # 15 tools — sub-accounts & API keys
│       ├── broker.py           # 10 tools — broker services
│       ├── otc.py              #  7 tools — OTC lending
│       ├── spread.py           # 11 tools — spread trading
│       ├── rfq.py              # 15 tools — block trading RFQ
│       ├── pre_upgrade.py      #  6 tools — pre-upgrade data
│       ├── announcement.py     #  2 tools — announcements
│       └── strategy.py         #  2 tools — arbitrage strategies
├── .env.example                # Environment variable template
├── pyproject.toml              # Project config & dependencies
└── LICENSE                     # MIT License

🔧 故障排除

MCP服务器未加载/“未配置MCP服务器”

如果您已配置服务器，但 /mcp 未显示任何工具或“未配置MCP服务器”：

1.检查配置文件是否正确

Claude Code从读取MCP服务器配置 ~/.claude.json （每个项目）， 不 从 ~/.claude/settings.json。建议通过CLI添加服务器：

claude mcp add bybit-mcp -- uv --directory /path/to/bybit-mcp run bybit.py

这会将配置写入正确的位置。如果您手动编辑 ~/.claude/settings.json，找不到服务器。

2.使用完整路径 uv

Claude Code生成MCP服务器子流程 不加载shell配置文件 (.zshrc / .zprofile)，所以 PATH 可能不包括 ~/.local/bin.使用绝对路径：

# Find your uv path
which uv
# Example output: /Users/yourname/.local/bin/uv

# Add with full path
claude mcp add bybit-mcp -- /Users/yourname/.local/bin/uv --directory /path/to/bybit-mcp run bybit.py

3.配置更改后重新启动Claude Code

MCP服务器在会话启动时连接。添加或更改配置后，您必须 退出并重新启动 Claude代码使更改生效。

4.验证服务器是否正确启动

测试服务器是否可以启动并响应MCP协议：

# Test import
uv run python -c "from src.main import main; print('Import OK')"

# Test MCP initialize handshake
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' | uv run bybit.py

如果导入失败，请运行 uv sync 安装依赖项。

5.不要手动运行服务器

Claude Code通过stdio管理MCP服务器进程本身。手动启动的服务器实例是 完全分开 --Claude Code不会连接到它。让Claude Code自动处理生命周期。

快速诊断检查表

症状 原因 修复
/mcp 显示“未配置MCP服务器” 配置文件错误(settings.json 而不是 .claude.json) 使用 claude mcp add CLI命令
配置已存在，但工具未加载 uv 找不到（PATH问题） 使用绝对路径 uv
之前加载但现在未加载的工具 配置更改后会话未重新启动 重新启动Claude代码
服务器手动工作，但不在克劳德代码中 手动服务器是一个单独的进程 不要手动启动；让Claude Code来管理它
启动时导入错误 未安装依赖项 运行 uv sync

⚠️ 免责声明

本软件仅用于教育和信息目的。

  • 非财务建议 --此工具不提供财务、投资或交易建议
  • 使用风险自负 --加密货币交易涉及巨大的损失风险
  • API安全 -保护您的API证书；使用IP限制并禁用提款权限
  • 测试优先 --始终测试 Bybit测试网 在使用实际资金之前(--testnet 旗帜）
  • 无担保 --软件按“原样”提供，不提供任何形式的保修

🤝 贡献

欢迎投稿！请随时提交拉取请求。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

添加新工具

  1. 在适当的位置添加您的工具功能 src/tools/*.py 模块
  2. 用…装饰 @mcp.tool()
  3. 使用 _public_get 未经认证或 _signed_get/_signed_post 对于经过身份验证的端点
  4. 就是这样——工具在导入时会自动注册

📚 资源

资源 描述
Bybit V5 API文档 Bybit API官方文档
Bybit测试网 练习用测试基金进行交易
MCP规范 模型上下文协议规范
uv包管理器 快速Python包管理器

📄 许可证

该项目根据MIT许可证获得许可——请参阅 许可证 文件以获取详细信息。

建于❤️ Bybit交易社区

相关 MCP