使用说明
CoinDCX MCP服务器
模型上下文协议(MCP)服务器,为Claude和其他人工智能助手提供CoinDCX加密货币交易所API集成。
特性
- 公开市场数据:访问股票行情、市场信息、订单簿、交易和烛台数据
- 账户管理:检查余额和用户信息
- 交易操作:创建、取消和监控订单
- 订单历史:检索当前订单和历史订单
- 安全认证:HMAC-SHA256签名请求
安装
- 克隆或下载此项目
- 安装依赖项:
cd coindcx-mcp
pip install -e .
配置
- 复制示例环境文件:
cp .env.example .env
- 编辑
.env并添加您的CoinDCX API凭证:
COINDCX_API_KEY=your_api_key_here
COINDCX_SECRET_KEY=your_secret_key_here
COINDCX_BASE_URL=https://api.coindcx.com
获取API密钥
- 注册地址: CoinDCX
- 转到帐户中的API设置
- 创建具有适当权限的新API密钥
- 将API密钥和密钥复制到您的
.env文件
使用Claude Desktop
将此服务器添加到您的Claude Desktop配置文件中:
macOS
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"coindcx": {
"command": "python",
"args": ["-m", "coindcx_mcp.server"],
"cwd": "/path/to/coindcx-mcp"
}
}
}
视窗
编辑 %APPDATA%/Claude/claude_desktop_config.json:
{
"mcpServers": {
"coindcx": {
"command": "python",
"args": ["-m", "coindcx_mcp.server"],
"cwd": "C:\\path\\to\\coindcx-mcp"
}
}
}
可用工具
公开市场数据
get_ticker:获取所有市场的股票行情数据get_markets:获取所有可用的交易对get_market_details:获取特定交易对的详细信息get_trades:获取市场的最新交易get_order_book:获取市场订单(出价/要价)get_candles:获取烛台/OHLCV数据
账户信息
get_balances:获取所有资产的账户余额get_user_info:获取用户帐户信息
交易
create_order:创建买入/卖出订单(市价、限价、止损)get_order_status:检查特定订单的状态cancel_order:取消现有订单get_active_orders:获取所有活动订单get_order_history:获取历史订单数据
Claude的查询示例
配置后,您可以向Claude询问以下问题:
- “CoinDCX的当前比特币价格是多少?”
- “显示我的账户余额”
- “以45000 USDT创建0.001 BTC的限价买入订单”
- “我的有效订单是什么?”
- “取消ID为12345的订单”
- “给我看看BTCUSD的订单簿”
安全说明
- 永远不要将API密钥提交到版本控制
- 使用环境变量或
.env凭证文件 - 考虑使用具有有限权限的API密钥进行测试
- 服务器使用HMAC-SHA256自动处理身份验证
发展
要直接运行服务器,请执行以下操作:
python -m coindcx_mcp.server
故障排除
- 身份验证错误:验证您的API密钥和机密是否正确
- 权限错误:确保您的API密钥具有所需的权限
- 网络错误:检查您的互联网连接和CoinDCX API状态
- 未找到工具:配置更改后重新启动Claude Desktop
API费率限制
CoinDCX对其API有利率限制。服务器将处理速率限制错误,但请注意:
- 订单创建:每60秒限制2000个请求
- 其他端点的限制各不相同
参见 CoinDCX API文档 对于当前的费率限制。
支持
有关此MCP服务器的问题,请检查:
- 您的API证书是正确的
- 您的网络连接稳定
- CoinDCX API正在运行
- Claude桌面配置已正确设置
许可证
本项目按原样提供,用于教育和发展目的。