项目简介

mcp-bybit-trader 是一个轻量级的 Model Context Protocol (MCP) 服务器，旨在为本地 AI 智能体提供安全高效的 Bybit API 访问能力。该服务器允许 AI 模型（如 ChatGPT 或其他 MCP 兼容客户端）在本地与 Bybit 交易所进行交互，获取实时市场数据、账户信息和执行订单操作，而无需将 API 密钥暴露到云端，保障了密钥的安全性。

主要功能点

安全的本地API访问: 无需将 Bybit API 密钥暴露到云端，所有操作在本地安全执行。
MCP 兼容服务器: 支持 MCP 协议，能够与各种 MCP 客户端（如 AI 智能体）无缝集成，实现上下文感知的交互。
快速部署和扩展性: 易于安装和配置，设计上考虑了扩展性，方便开发者和量化研究人员使用。
提供交易工具: 内置了访问 Bybit 交易 API 的工具，例如获取账户信息、下单等。
支持 Prompt 定制: 允许用户自定义 Prompt 模板，灵活控制与 LLM 的交互方式。

安装步骤

克隆仓库:

git clone https://github.com/dlwjdtn535/mcp-bybit-trader
cd mcp-bybit-trader

创建并激活虚拟环境 (推荐):

python3 -m venv venv
source venv/bin/activate  # 或 venv\Scripts\activate for Windows

安装依赖:

pip install -r requirements.txt

配置环境变量:
- 复制 '.env.example' 文件并重命名为 '.env'。
- 修改 '.env' 文件，填入你的 Bybit API 密钥 (ACCESS_KEY, SECRET_KEY) 和 MEMBER_ID。

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接到此 MCP 服务器。请注意，此配置应在 MCP 客户端中设置，而不是在此服务器端配置。

{
  "mcpServers": {
    "bybit_trader": {  // 服务器名称，可以自定义
      "command": "python",  // 启动服务器的命令，这里假设使用 python 解释器
      "args": ["src/main.py"]  // 启动命令的参数，指向服务器主程序入口
    }
  }
}

参数注释:

'server name': 'bybit_trader' - MCP 服务器的名称，客户端用此名称来引用和连接服务器。可以自定义。
'command': '"python"' - 启动 MCP 服务器的命令。假设您的 Python 环境已配置好，可以直接使用 'python' 命令。
'args': '["src/main.py"]' - 传递给启动命令的参数，这里指定了服务器主程序入口为 'src/main.py'。客户端会执行 'python src/main.py' 命令来启动 MCP 服务器。

基本使用方法

启动 MCP 服务器: 在终端中，确保已激活虚拟环境，并执行以下命令启动服务器：
```
python src/main.py
```
服务器默认使用 'stdio' 传输协议，启动后将等待 MCP 客户端的连接和请求。
配置 MCP 客户端: 在您的 MCP 客户端 (如 AI 智能体) 中，配置上述 '服务器配置' JSON 信息，确保客户端能够找到并连接到正在运行的 'mcp-bybit-trader' 服务器。

与服务器交互: 通过 MCP 客户端，您可以调用服务器提供的工具 (Tools) 和 Prompt 模板 (Prompts) 来与 Bybit API 进行交互。

例如，您可以使用客户端发送请求调用 'get_seminar_details' 工具（尽管此工具在示例代码中与 Bybit 交易无关，实际使用中需要替换为与 Bybit 交易相关的工具，例如获取账户余额、下单等，这需要您根据仓库的完整代码进行调整和扩展）。

{
  "jsonrpc": "2.0",
  "method": "call",
  "params": {
    "tool_call": {
      "tool_name": "get_seminar_details",
      "parameters": {
        "party_name": "Python 세미나"
      }
    }
  },
  "id": "123"
}

注意:

示例代码 'main.py' 中提供的 'get_seminar_details' 和 'register_attendee' 工具以及 'prompt' 模板是用于演示 MCP 服务器基本结构的示例，与 Bybit 交易功能无关。
要实现与 Bybit 交易所的实际交互，您需要根据仓库的完整代码 (如果仓库包含 Bybit 交易相关的工具和服务，例如 'src/service/trade_service.py' 和 'src/service/candle_service.py' 中可能包含相关功能) 来扩展和修改 'main.py' 中的工具和 Prompt 模板，使其能够调用 'BybitTradeService' 和 'CandleService' 中提供的 Bybit API 访问功能。
请务必仔细阅读仓库中的代码和文档，了解如何使用提供的服务和工具，并根据您的需求进行定制和开发。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息