内容
# 位昆MCP服务器
[](https://smithery.ai/server/node2flow/bitkub)
[](https://www.npmjs.com/package/@node2flow/bitkub-mcp)
[](https://opensource.org/licenses/MIT)
适用于位昆API的MCP（模型上下文协议）服务器 - 泰国领先的加密货币交易所。通过28种工具进行市场数据、交易、订单、钱包和加密货币管理。
与Claude Desktop、Cursor、VS Code和任何MCP客户端配合使用。
> **警告**：此软件包与真实的加密货币交易所交互。所有交易和提现操作都使用**真实货币**。请谨慎使用。
---
## 快速入门
### Claude Desktop
添加到 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"bitkub": {
"command": "npx",
"args": ["-y", "@node2flow/bitkub-mcp"],
"env": {
"BITKUB_API_KEY": "您的API密钥",
"BITKUB_SECRET_KEY": "您的密钥"
}
}
}
}
```
### Cursor / VS Code
添加到MCP设置：
```json
{
"mcpServers": {
"bitkub": {
"command": "npx",
"args": ["-y", "@node2flow/bitkub-mcp"],
"env": {
"BITKUB_API_KEY": "您的API密钥",
"BITKUB_SECRET_KEY": "您的密钥"
}
}
}
}
```
### 仅市场数据（无需API密钥）
市场数据工具（10种工具）无需API密钥即可工作：
```json
{
"mcpServers": {
"bitkub": {
"command": "npx",
"args": ["-y", "@node2flow/bitkub-mcp"]
}
}
}
```
### HTTP模式（可流式HTTP）
```bash
BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npx @node2flow/bitkub-mcp --http
```
服务器在端口3000上启动（可通过`PORT`环境变量配置）。MCP端点：`http://localhost:3000/mcp`
---
## 配置
| 环境变量 | 是否必需 | 描述 |
|---|---|---|
| `BITKUB_API_KEY` | 用于交易 | 来自位昆的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` | 下达买入订单（LIMIT或MARKET） |
| `btk_place_ask` | 下达卖出订单（LIMIT或MARKET） |
| `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` | 转账至位昆用户（不可逆） |
| `btk_crypto_deposit_history` | 获取存款历史记录 |
| `btk_crypto_withdraw_history` | 获取提现历史记录 |
| `btk_crypto_generate_address` | 生成新的存款地址 |
---
## 测试端点
位昆提供用于下单的测试（模拟运行）端点。**始终在下真实订单之前进行测试：**
```
btk_place_bid_test — 验证买入订单，无需花费资金
btk_place_ask_test — 验证卖出订单，无需花费资金
```
这些端点检查参数、余额和交易规则，然后返回订单的样子 - 但不执行。
---
## 要求
- **Node.js** 18+
- **位昆账户**，带有API密钥（用于交易操作）
### 如何获取API密钥
1. 登录 [bitkub.com](https://www.bitkub.com)
2. 在账户设置中导航至 **API管理**
3. 创建新的API密钥
4. 设置权限：读取、交易、提现、存款
5. 复制 **API密钥** 和 **密钥**
6. 为安全起见设置 **IP白名单**
### 安全最佳实践
- **绝不分享** API密钥或密钥
- 在API密钥设置中使用 **IP白名单**
- 将权限限制在您需要的范围内
- 用于市场数据监控的 **只读密钥**
- 将密钥存储在 **环境变量** 中，而不是代码中
- 定期 **轮换密钥**
---
## 风险警告
- 所有操作都在 **真实交易所** 中执行，使用的 **真实资金**
- **提现不可逆** - 仔细检查地址和金额
- **速率限制** - 超出限制会导致30秒的阻塞（HTTP 429）
- **市场风险** - 加密货币价格波动性高
- **订单历史记录** 90天后会被存档
- 在下真实订单之前，始终使用 **测试端点**
---
## 开发者
```bash
git clone https://github.com/node2flow-th/bitkub-mcp-community.git
cd bitkub-mcp-community
npm install
npm run build
# 以stdio模式运行（仅限市场数据）
npm start
# 以完全访问权限运行
BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npm start
# 以HTTP模式运行
BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npm start -- --http
```
---
## 许可证
MIT许可证 - 请参阅 [LICENSE](LICENSE)
版权（c）2026 [Node2Flow](https://node2flow.net)
## 链接
- [npm软件包](https://www.npmjs.com/package/@node2flow/bitkub-mcp)
- [位昆API文档](https://github.com/bitkub/bitkub-official-api-docs)
- [MCP协议](https://modelcontextprotocol.io/)
- [Node2Flow](https://node2flow.net)
