使用说明
Bitkub MCP服务器
Bitkub API的MCP(模型上下文协议)服务器-泰国领先的加密货币交易所。通过28个工具进行市场数据、交易、订单、钱包和加密管理。
适用于Claude Desktop、Cursor、VS Code和任何MCP客户端。
警告:此包与真正的加密货币交易所交互。所有交易和提款操作均使用 真钱请谨慎使用。
快速开始
克劳德桌面版
添加到 claude_desktop_config.json:
{
"mcpServers": {
"bitkub": {
"command": "npx",
"args": ["-y", "@node2flow/bitkub-mcp"],
"env": {
"BITKUB_API_KEY": "your-api-key",
"BITKUB_SECRET_KEY": "your-secret-key"
}
}
}
}
光标/VS代码
添加到MCP设置:
{
"mcpServers": {
"bitkub": {
"command": "npx",
"args": ["-y", "@node2flow/bitkub-mcp"],
"env": {
"BITKUB_API_KEY": "your-api-key",
"BITKUB_SECRET_KEY": "your-secret-key"
}
}
}
}
仅限市场数据(无API密钥)
市场数据工具(10个工具)在没有API密钥的情况下工作:
{
"mcpServers": {
"bitkub": {
"command": "npx",
"args": ["-y", "@node2flow/bitkub-mcp"]
}
}
}
HTTP模式(流式HTTP)
BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npx @node2flow/bitkub-mcp --http
服务器在端口3000上启动(可通过配置 PORT env变量)。MCP端点: http://localhost:3000/mcp
配置
| 环境变量 | 必填 | 说明 |
|---|---|---|
BITKUB_API_KEY |
用于交易 | Bitkub的API密钥 |
BITKUB_SECRET_KEY |
用于交易 | HMAC签名的密钥 |
PORT |
否 | HTTP服务器的端口(默认值: 3000,只与 --http) |
所有工具(28个工具)
一般/市场数据(10个工具)-不需要API密钥
| 工具 | 说明 |
|---|---|
btk_server_time |
获取服务器时间(用于时间戳同步) |
btk_server_status |
获取API服务器状态 |
btk_symbols |
列出所有交易品种及其规则 |
btk_ticker |
获取24小时行情(价格、交易量、变化) |
btk_recent_trades |
获取某个交易品种的最近交易 |
btk_bids |
获取买方订单簿 |
btk_asks |
获取卖方订单簿 |
btk_books |
获取完整的订单簿(出价+要价) |
btk_depth |
获得市场深度 |
btk_tradingview_history |
获取OHLCV烛台数据 |
账户(4个工具)
| 工具 | 说明 |
|---|---|
btk_wallet |
获取可用余额 |
btk_balances |
获取全部余额(可用+预留) |
btk_trading_credits |
获取交易信用余额 |
btk_user_limits |
获取存款/取款限额 |
订单(8个工具)
| 工具 | 说明 |
|---|---|
btk_place_bid |
下达买入订单(限价或市价) |
btk_place_ask |
下达卖出订单(限价或市价) |
btk_place_bid_test |
试购订单(模拟运行,无真钱) |
btk_place_ask_test |
试卖订单(模拟,无真钱) |
btk_cancel_order |
取消特定订单 |
btk_my_open_orders |
获取所有未结/待处理订单 |
btk_my_order_history |
获取订单历史记录(分页) |
btk_order_info |
通过填写历史记录获取详细的订单信息 |
加密货币/钱包(6工具)
| 工具 | 说明 |
|---|---|
btk_crypto_addresses |
列出加密货币存款地址 |
btk_crypto_withdraw |
提取加密货币(不可逆) |
btk_crypto_internal_withdraw |
转移到Bitkub用户(不可逆转) |
btk_crypto_deposit_history |
获取存款历史记录 |
btk_crypto_withdraw_history |
获取提款历史记录 |
btk_crypto_generate_address |
生成新的存款地址 |
测试终点
Bitkub为下单提供测试(模拟运行)端点。 在下实际订单之前始终进行测试:
btk_place_bid_test — Validate buy order without spending money
btk_place_ask_test — Validate sell order without spending money
这些端点检查参数、余额和交易规则,然后在不执行订单的情况下返回订单的样子。
需求
- Node.js 18+
- Bitkub账户 带有API密钥(用于交易操作)
如何获取API密钥
- 首选 bitkub.com 并登录
- 导航至 API管理 在帐户设置中
- 创建新的API密钥
- 设置权限:读取、交易、提款、存款
- 复制这两个 API密钥 和 密钥
- 设置 IP白名单 出于安全考虑
安全最佳实践
- 从不分享 API密钥或密钥
- 使用IP白名单 在API密钥设置中
- 限制权限 只给你需要的东西
- 只读密钥 用于市场数据监控
- 将机密存储在环境变量中,从不在代码中
- 定期旋转按键
风险提示
- 所有操作均在 真正的交换 随着 真钱
- 提款是不可逆转的 --仔细核对地址和金额
- 费率限制 --超过限制阻止30秒(HTTP 429)
- 市场风险 --加密货币价格波动很大
- 订单历史 超过90天已存档
- 总是使用 测试终点 在下真正的订单之前
对于开发者
git clone https://github.com/node2flow-th/bitkub-mcp-community.git
cd bitkub-mcp-community
npm install
npm run build
# Run in stdio mode (market data only)
npm start
# Run with full access
BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npm start
# Run in HTTP mode
BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npm start -- --http
许可证
MIT许可证-请参阅 许可证
版权所有(c)2026 Node2Flow
