🚀 hchain-mcp / hchain-skills
AI 原生多链交易 MCP Server — 116 个工具 + 18 个组合技能，让 AI Agent 拥有链上超能力
📦 双包同源：
hchain-skills（主力）·hchain-mcp（覆盖旧引用）—— 两个包内容完全一致 🔒 v1.5.0 生产级：307 测试 · WS 自动重连 · API 超时重试 · 结构化日志
✨ 为什么选择 hchain-skills？
⚡ 30 秒开始
# 1. 安装（二选一，内容一样）
npm install -g hchain-skills # 主力包
npm install -g hchain-mcp # 兼容旧引用
# 2. 获取 API Key → https://web3.okx.com/onchainos/dev-portal
# 3. 配置 Claude Code
{
"mcpServers": {
"hchain-skills": {
"command": "npx",
"args": ["hchain-skills"],
"env": {
"OKX_API_KEY": "你的API_KEY",
"OKX_SECRET_KEY": "你的SECRET_KEY",
"OKX_PASSPHRASE": "你的PASSPHRASE"
}
}
}
}
# 4. 重启 Claude Code，说一句试试：
"看看我 ETH 钱包里有什么币"
"ETH 现在多少钱"
"调研一下 0xABC 这个代币安不安全"
🎯 5 分钟上手
🧰 功能地图
💰 余额 & 资产
🔍 行情 & 代币
⚠️ 安全 & 风控
🔄 交易 & 兑换
📡 信号 & 聪明钱
🏦 DeFi & 支付
🏗️ 链上赚币
hchain-skills 内置 10 个专业 Agent，自动协作处理复杂任务：
你的意图 → Orchestrator
├── market-analyst (行情分析)
├── risk-assessor (风控评估)
├── trade-executor (交易执行)
├── portfolio-tracker(资产追踪)
├── signal-scout (信号侦察)
├── defi-strategist (DeFi策略)
└── social-analyst (社媒分析)
只需自然语言描述需求，Orchestrator 自动分解、路由、汇总。
🚀 运行方式
stdio 模式（Claude Code 集成）
hchain-skills
HTTP 模式（远程 Agent / 自定义客户端）
hchain-skills start:http
# MCP 端点: POST http://127.0.0.1:3000/mcp
# 健康检查: GET http://127.0.0.1:3000/health
Docker
docker build -t hchain-skills .
docker run --rm -e OKX_API_KEY=xxx -e OKX_SECRET_KEY=xxx -e OKX_PASSPHRASE=xxx hchain-skills
🆘 常见问题
API Key 哪里获取？
→ OKX OnchainOS 开发者门户，免费注册即可获取。
报 AUTH_ERROR？
- 检查
OKX_API_KEY/OKX_SECRET_KEY/OKX_PASSPHRASE三个环境变量是否都已设置 - 确认 API Key 未被吊销，到开发者门户重新生成
- 确认系统时间与标准时间偏差在 30 秒以内（签名时间戳敏感）
报 RATE_LIMITED？
请求频率过高。等待 1-5 秒后重试，或降低并发查询数量。
支持哪些链？
Ethereum、BSC、Polygon、Arbitrum、Base、Optimism、Solana、Sui、TON、Avalanche、Fantom 等 40+ 链。具体调 onchainos_balance_supported_chain 查看。
交易需要签名吗？
所有写入链上的操作（兑换、授权、广播）都需要用户离线签名。hchain-skills 只构建 calldata，绝不代签。
如何验证 MCP 连接成功？
在 Claude Code 中说 "调用 onchainos_help 看看有哪些功能"，如果返回工具列表则连接成功。
📦 模块总览（116 tools）
🔗 链接
MIT · Made with ❤️ for AI Agents