aiowhitebit-mcp

基本能力

产品定位

aiowhitebit-mcp 是一个为 WhiteBit 加密货币交易所 API 实现的消息控制协议（MCP）服务器和客户端，旨在简化与 WhiteBit API 的交互。

核心功能

• 支持 WhiteBit API 的公共和私有端点
• 支持 WebSocket API
• 提供易于使用的客户端与 MCP 服务器交互
• 提供命令行界面运行服务器
• 支持多种传输协议（stdio、SSE、WebSocket）
• 与 Claude Desktop 集成

适用场景

• 加密货币交易自动化
• 实时市场数据监控
• 交易策略执行
• 与 Claude Desktop 集成开发

工具列表

公共 API 工具

• get_market_info: 获取所有可用市场的信息
• get_market_activity: 获取所有市场的活动信息
• get_server_time: 获取当前服务器时间
• get_server_status: 获取当前服务器状态
• get_asset_status_list: 获取所有资产的状态
• get_orderbook: 获取特定市场的订单簿
• get_recent_trades: 获取特定市场的最近交易
• get_fee: 获取特定市场的交易费用

私有 API 工具

• get_trading_balance: 获取所有资产的交易余额
• create_limit_order: 创建限价订单
• create_stop_limit_order: 创建止损限价订单
• active_orders: 获取活动订单
• cancel_order: 取消订单

WebSocket 工具

• get_last_price: 使用 WebSocket 获取特定市场的最后价格
• get_market_depth: 使用 WebSocket 获取特定市场的市场深度

常见问题解答

• 如何安装？使用 pip install aiowhitebit-mcp 或从源代码安装
• 如何运行服务器？使用 aiowhitebit-mcp 命令，可选择不同的传输协议
• 如何提供 API 凭证？通过环境变量或命令行参数

使用教程

使用依赖

• Python 3.6+
• pip

安装教程

pip install aiowhitebit-mcp

或从源代码安装：

git clone https://github.com/yourusername/aiowhitebit-mcp.git
cd aiowhitebit-mcp
pip install -e .

调试方式

运行服务器：

# 使用 stdio 传输
aiowhitebit-mcp --transport stdio

# 使用 SSE 传输
aiowhitebit-mcp --transport sse --host 127.0.0.1 --port 8000

# 使用 WebSocket 传输
aiowhitebit-mcp --transport ws --host 127.0.0.1 --port 8000

提供 API 凭证：

export WHITEBIT_API_KEY="your_api_key"
export WHITEBIT_API_SECRET="your_api_secret"
aiowhitebit-mcp

或

aiowhitebit-mcp --api-key "your_api_key" --api-secret "your_api_secret"

与 Claude Desktop 集成：

fastmcp install examples/run_server.py --name "WhiteBit API"

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。