hvip-mcp-server 0.2.40 → 0.2.43
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +101 -3
- package/dist/index.js +14942 -9678
- package/package.json +23 -3
package/README.md
CHANGED
|
@@ -1,3 +1,101 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
OKX API 全景图 —— 让任何 AI Agent 都能使用 OKX 的全部能力。
|
|
1
|
+
# hvip MCP Server
|
|
2
|
+
|
|
3
|
+
> OKX API 全景图 —— 让任何 AI Agent 都能使用 OKX 的全部能力。
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/hvip-mcp-server)
|
|
6
|
+
[](https://github.com/okx-wallet-H/hvip-mcp/blob/master/LICENSE)
|
|
7
|
+
[](https://github.com/okx-wallet-H/hvip-mcp)
|
|
8
|
+
|
|
9
|
+
📦 **仓库**: [github.com/okx-wallet-H/hvip-mcp](https://github.com/okx-wallet-H/hvip-mcp)
|
|
10
|
+
🐛 **Issue**: [提交反馈](https://github.com/okx-wallet-H/hvip-mcp/issues/new)
|
|
11
|
+
📖 **贡献**: [CONTRIBUTING.md](./CONTRIBUTING.md)
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 快速开始
|
|
16
|
+
|
|
17
|
+
### 1. Claude Desktop 接入
|
|
18
|
+
|
|
19
|
+
在 Claude Desktop 配置中添加：
|
|
20
|
+
|
|
21
|
+
```json
|
|
22
|
+
{
|
|
23
|
+
"mcpServers": {
|
|
24
|
+
"hvip-mcp": {
|
|
25
|
+
"command": "npx",
|
|
26
|
+
"args": ["-y", "hvip-mcp-server"],
|
|
27
|
+
"env": {
|
|
28
|
+
"OKX_API_KEY": "<你的API Key>",
|
|
29
|
+
"OKX_SECRET_KEY": "<你的Secret Key>",
|
|
30
|
+
"OKX_PASSPHRASE": "<你的Passphrase>"
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### 2. 直接运行
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
npx hvip-mcp-server
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### 3. 本地开发
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
git clone https://github.com/okx-wallet-H/hvip-mcp.git
|
|
47
|
+
cd hvip-mcp
|
|
48
|
+
npm install
|
|
49
|
+
npm run build
|
|
50
|
+
npm start
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## 工具覆盖
|
|
56
|
+
|
|
57
|
+
| 模块 | 工具数 | 说明 |
|
|
58
|
+
|------|--------|------|
|
|
59
|
+
| 🔹 **交易类** | 40+ | 下单/撤单/改单/批量/策略委托 |
|
|
60
|
+
| 🔹 **行情类** | 30+ | Ticker/K线/深度/资金费率/标记价 |
|
|
61
|
+
| 🔹 **数据类** | 50+ | 产品信息/多空比/买卖量/PCR/统计数据 |
|
|
62
|
+
| 🔹 **资金类** | 40+ | 划转/提现/充值/余额/持仓/杠杆 |
|
|
63
|
+
| 🔹 **策略类** | 20+ | 网格/信号/跟单/价差/RFQ |
|
|
64
|
+
| 🔹 **金融类** | 15+ | 赚币/质押/借贷/法币 |
|
|
65
|
+
| 🔹 **预测市场** | 9+ | 事件/市场/深度/套利检测 |
|
|
66
|
+
| 🔹 **Skill 组合** | 4 | 账户全景/市场速览/下单预检/反馈 |
|
|
67
|
+
|
|
68
|
+
**304 个 MCP 工具 · 覆盖 97.7% OKX REST API · P0 P1 全部清零**
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## 架构
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
原子层 (300+ 工具) → AI Agent 直接调用
|
|
76
|
+
↓
|
|
77
|
+
Skill 组合层 (4 个) → 串联多工具，一次完成复杂任务
|
|
78
|
+
↓
|
|
79
|
+
反馈通道 → GitHub Issues → 新 Skill 需求 → AI Agent 自行实现并提 PR
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## 贡献
|
|
85
|
+
|
|
86
|
+
AI Agent 或开发者都可以贡献 Skill：
|
|
87
|
+
|
|
88
|
+
1. 阅读 [`CLAUDE.md`](./CLAUDE.md) 了解项目规范
|
|
89
|
+
2. 阅读 [`CONTRIBUTING.md`](./CONTRIBUTING.md) 了解提交流程
|
|
90
|
+
3. Fork → 创建 Skill → 提 PR → Review → 合并
|
|
91
|
+
|
|
92
|
+
每个 Skill 串联多个原子工具，解决一个具体的使用场景。
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 文档
|
|
97
|
+
|
|
98
|
+
- [`CLAUDE.md`](./CLAUDE.md) — AI Agent 项目指南
|
|
99
|
+
- [`CONTRIBUTING.md`](./CONTRIBUTING.md) — Skill 贡献流程
|
|
100
|
+
- [`docs/OKX-MCP-API对接标准-v0.1.8.md`](./docs/OKX-MCP-API对接标准-v0.1.8.md) — API 对接规范
|
|
101
|
+
- [`docs/OKX-MCP-防幻觉对接SOP-v1.0.md`](./docs/OKX-MCP-防幻觉对接SOP-v1.0.md) — 防幻觉 SOP
|