Bybit Mcp Server

金融 TypeScript

🚀 Bybit MCP Server

Bybit MCP Server 是一个适用于 Bybit 交易所的模型上下文协议（MCP）服务器，它能让 Claude Code 和 Cursor 等 AI 编码工具与 Bybit 的交易平台进行交互。

🚀 快速开始

📦 安装指南

npm install -g bybit-mcp-server

⚙️ 配置说明

这个 MCP 服务器可以与各种支持 MCP 的 AI 工具一起使用：

Claude Code 配置

测试网（推荐 - 适合测试）：在 claude_desktop_config.json 中添加以下内容：

{
"mcpServers": {
"bybit": {
"command": "npx",
"args": ["bybit-mcp-server"],
"env": {
"BYBIT_API_KEY": "your_testnet_api_key",
"BYBIT_API_SECRET": "your_testnet_api_secret",
"BYBIT_ENVIRONMENT": "testnet"
}
}
}
}

主网（⚠️ 警告：使用真实资金）：在 claude_desktop_config.json 中添加以下内容：

{
"mcpServers": {
"bybit": {
"command": "npx",
"args": ["bybit-mcp-server"],
"env": {
"BYBIT_API_KEY": "your_mainnet_api_key",
"BYBIT_API_SECRET": "your_mainnet_api_secret",
"BYBIT_ENVIRONMENT": "mainnet"
}
}
}
}

Cursor 配置

使用与上述 Claude Code 相同的配置，但将其添加到 .cursor/mcp_config.json 中，并使用 mcp.servers 而不是 mcpServers。

🌐 环境设置

选项 1：测试网（推荐）

BYBIT_API_KEY=your_testnet_api_key_here
BYBIT_API_SECRET=your_testnet_api_secret_here
BYBIT_ENVIRONMENT=testnet
DEBUG=false

选项 2：主网（⚠️ 使用真实资金）

BYBIT_API_KEY=your_mainnet_api_key_here
BYBIT_API_SECRET=your_mainnet_api_secret_here
BYBIT_ENVIRONMENT=mainnet
DEBUG=false

🔑 获取 API 密钥

测试网：

访问 Bybit 测试网
注册一个账户
进入 API 管理并创建 API 密钥
启用所需权限（读取、交易）

主网：

访问 Bybit
完成账户验证
进入 API 管理并创建 API 密钥
启用所需权限（读取、交易）
设置 IP 限制以增强安全性

✨ 主要特性

市场数据

get_price - 获取交易对的当前价格
get_orderbook - 获取交易对的订单簿深度
get_klines - 获取历史 K 线数据
get_24hr_ticker - 获取 24 小时交易统计信息

账户管理

get_account_info - 获取账户信息和余额
get_wallet_balance - 获取特定账户类型的钱包余额
get_open_orders - 获取未成交/活跃订单列表
get_order_history - 获取历史订单

交易（⚠️ 主网可使用真实资金）

place_order - 下单
cancel_order - 取消现有订单
cancel_all_orders - 取消某个交易对或类别的所有订单

💻 使用示例

你可以向你的 AI 助手提出以下请求：

"获取 Bybit 上 BTCUSDT 的当前价格"
"显示 ETHUSDT 50 档的订单簿"
"查看我的账户余额"
"以 45000 美元的价格限价买入 0.1 个比特币"
"取消我所有 BTCUSDT 的未成交订单"
"获取我最近 20 笔交易的历史记录"

⚠️ 安全说明

⚠️ 重要提示

测试网 是默认且推荐的安全环境。

主网操作使用真实资金，请务必谨慎使用。

API 密钥会自动从错误消息中屏蔽。

在使用主网之前，务必在测试网上进行充分测试。

在主网进行交易操作时会显示警告信息。

💡 使用建议

切勿将 API 密钥提交到版本控制系统。

使用环境变量来存储凭证。

定期轮换你的 API 密钥。

在 Bybit API 设置中使用 IP 限制。

🛠️ 开发说明

npm run build     # 编译 TypeScript
npm run dev       # 开发模式
npm run lint      # 运行代码检查
npm run typecheck # 类型检查
npm run watch     # 监听模式

本地开发

克隆仓库：

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

安装依赖：

npm install

设置环境：

cp .env.example .env
# 使用你的 API 凭证编辑 .env 文件

以开发模式运行：

npm run dev

📋 配置选项

属性	详情
`BYBIT_API_KEY`	你的 Bybit API 密钥
`BYBIT_API_SECRET`	你的 Bybit API 密钥的密钥
`BYBIT_ENVIRONMENT`	`testnet` 或 `mainnet`，默认为 `testnet`
`BYBIT_BASE_URL`	自定义 API 基础 URL，自动检测
`DEBUG`	启用调试日志，默认为 `false`

📚 详细文档

本服务器实现了 Bybit 的 V5 API 端点。详细的 API 文档请参考：

🤝 贡献指南

分叉仓库
创建你的功能分支 (git checkout -b feature/amazing-feature)
提交你的更改 (git commit -m 'Add some amazing feature')
推送到该分支 (git push origin feature/amazing-feature)
打开一个拉取请求

📄 许可证

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

🎈 支持与反馈

0 条评论
分类：金融