加密货币交易服务器

Bitkub MCP Server 是一个为泰国领先的加密货币交易所Bitkub API设计的模型上下文协议服务器,提供市场数据、交易、订单、钱包和加密货币管理功能。

  • by node2flow-th
  • TypeScript
  • 混合部署
  • 1 星标
  • 更新于
在 GitHub 查看 node2flow-th/bitkub-mcp-community

使用说明

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密钥

  1. 首选 bitkub.com 并登录
  2. 导航至 API管理 在帐户设置中
  3. 创建新的API密钥
  4. 设置权限:读取、交易、提款、存款
  5. 复制这两个 API密钥 和 密钥
  6. 设置 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

链接