hvip-mcp-server 0.2.53 → 0.2.55

package/dist/index.js

@@ -34833,33 +34833,17 @@ function registerAgentUtils(server, auth) {
   const CATALOG = {
     _instruction: [
       "\u4F60\u662F hvip MCP Server \u7684 AI Agent\u3002\u6536\u5230\u672C\u76EE\u5F55\u540E\uFF0C\u4F60\u5DF2\u7ECF\u638C\u63E1\u5168\u90E8\u5FC5\u8981\u4FE1\u606F\uFF0C\u65E0\u9700\u518D\u626B\u63CF tools/list\u3002",
-      "\u5DE5\u4F5C\u6D41: 1) \u770B _setup \u4E86\u89E3\u8FDE\u63A5\u72B6\u6001 -> 2) _onboarding \u51B3\u5B9A\u7B2C\u4E00\u6B65 -> 3) \u5339\u914D\u7528\u6237\u610F\u56FE\u5230\u57DF -> 4) \u7528 go_to_params \u76F4\u63A5\u8C03\u76EE\u6807\u5DE5\u5177\u3002",
-      "\u4E0D\u786E\u5B9A\u57DF\u65F6\u8C03\u7528 agent_catalog_detail { domain } \u67E5\u770B\u8BE5\u57DF\u7684\u8BE6\u7EC6\u5DE5\u5177\u6E05\u5355\u3002",
+      "\u5DE5\u4F5C\u6D41: 1) \u770B _setup \u4E86\u89E3\u8FDE\u63A5\u72B6\u6001\u548C API Key \u914D\u7F6E \u2192 2) \u65E0Key\u65F6\u4F18\u5148\u770B publicDomains\uFF08\u7ACB\u5373\u53EF\u7528\uFF09\uFF0C\u6709Key\u65F6\u5168\u90E8\u53EF\u7528 \u2192 3) \u5339\u914D\u7528\u6237\u610F\u56FE\u5230\u57DF \u2192 4) \u7528 go_to_params \u76F4\u63A5\u8C03\u76EE\u6807\u5DE5\u5177\u3002",
+      "\u26A0\uFE0F authDomains \u4E2D\u7684\u6240\u6709\u5DE5\u5177\u9700\u8981 API Key\u2014\u2014\u6CA1\u6709 Key \u65F6\u544A\u8BC9\u7528\u6237\u5982\u4F55\u914D\u7F6E\uFF0C\u4E0D\u8981\u5C1D\u8BD5\u8C03\u7528\u3002",
       "\u6240\u6709 WRITE/FUND_TRANSFER/ADMIN \u5DE5\u5177\u9700\u7528\u6237\u786E\u8BA4\u540E\u8C03\u7528\uFF0C\u4E0D\u53EF\u81EA\u52A8\u53D1\u8D77\u3002"
     ].join(" "),
     domains: [
-      {
-        domain: "\u8D26\u6237\u8D44\u4EA7",
-        what: "\u67E5\u770B\u8D26\u6237\u4F59\u989D\u3001\u6301\u4ED3\u3001\u914D\u7F6E\u3001\u624B\u7EED\u8D39\u3001\u4F30\u503C",
-        when: ["\u6211\u7684\u8D26\u6237", "\u6301\u4ED3", "\u4F59\u989D", "\u4FDD\u8BC1\u91D1", "\u6760\u6746\u500D\u6570", "\u8D44\u4EA7\u4F30\u503C", "\u624B\u7EED\u8D39\u7387", "\u8D26\u6237\u914D\u7F6E"],
-        go_to: "okx_account_overview",
-        also: [
-          "okx_get_balance \u2014 \u5404\u5E01\u79CD\u4F59\u989D\u660E\u7EC6",
-          "okx_get_positions \u2014 \u6301\u4ED3\u8BE6\u60C5\uFF08\u542B\u5E73\u4ED3\u4E0A\u4E0B\u6587 _actionContext\uFF09",
-          "okx_get_account_config \u2014 \u8D26\u6237\u6A21\u5F0F/\u6301\u4ED3\u6A21\u5F0F",
-          "okx_get_asset_valuation \u2014 \u603B\u8D44\u4EA7\u4F30\u503C",
-          "okx_get_fee_rates \u2014 \u624B\u7EED\u8D39\u7387",
-          "okx_get_leverage_info \u2014 \u5F53\u524D\u6760\u6746\u500D\u6570",
-          "okx_get_max_size \u2014 \u6700\u5927\u53EF\u5F00\u6570\u91CF",
-          "okx_set_leverage \u2014 \u8C03\u6574\u6760\u6746\uFF08WRITE\uFF0C\u9700\u786E\u8BA4\uFF09"
-        ],
-        risk: "READ"
-      },
       {
         domain: "\u884C\u60C5\u770B\u76D8",
         what: "\u67E5\u770B\u4EA7\u54C1\u4EF7\u683C\u3001K\u7EBF\u3001\u6DF1\u5EA6\u3001\u6210\u4EA4\u8BB0\u5F55",
         when: ["BTC\u4EF7\u683C", "ETH\u884C\u60C5", "K\u7EBF", "\u6DA8\u8DCC", "\u6DF1\u5EA6", "\u76D8\u53E3", "\u6210\u4EA4\u8BB0\u5F55", "\u8D70\u52BF"],
         go_to: "okx_quick_market",
+        go_to_params: "instId (\u5982 BTC-USDT\u3001ETH-USDT-SWAP)",
         also: [
           "okx_get_ticker \u2014 \u5355\u4E2A\u4EA7\u54C1\u5B9E\u65F6\u884C\u60C5",
           "okx_get_tickers \u2014 \u67D0\u7C7B\u578B\u5168\u90E8\u4EA7\u54C1\u884C\u60C5",
@@ -34870,13 +34854,122 @@ function registerAgentUtils(server, auth) {
           "okx_get_index_candles \u2014 \u6307\u6570K\u7EBF",
           "okx_get_mark_price_candles \u2014 \u6807\u8BB0\u4EF7K\u7EBF"
         ],
-        risk: "READ"
+        risk: "READ",
+        authRequired: false
+      },
+      {
+        domain: "\u5E02\u573A\u626B\u63CF",
+        what: "\u53D1\u73B0\u5E02\u573A\u673A\u4F1A\u3001\u6DA8\u5E45\u699C\u3001\u8DCC\u5E45\u699C\u3001\u8D44\u91D1\u8D39\u7387\u5F02\u5E38",
+        when: ["\u4ECA\u5929\u6709\u4EC0\u4E48\u673A\u4F1A", "\u6DA8\u5E45\u699C", "\u8DCC\u5E45\u699C", "\u4EC0\u4E48\u5728\u6DA8", "\u4EC0\u4E48\u5728\u8DCC", "\u5F02\u52A8", "\u626B\u63CF"],
+        go_to: "agent_market_scan",
+        go_to_params: "instType? (\u9ED8\u8BA4SWAP), topN? (\u9ED8\u8BA410), sortBy? (change|vol|fundingRate)",
+        also: [
+          "okx_quick_market \u2014 \u6DF1\u5165\u770B\u67D0\u4E2A\u54C1\u79CD",
+          "okx_get_funding_rate \u2014 \u6C38\u7EED\u5408\u7EA6\u8D44\u91D1\u8D39\u7387",
+          "okx_get_tickers \u2014 \u5168\u5E02\u573A\u884C\u60C5"
+        ],
+        risk: "READ",
+        authRequired: false
+      },
+      {
+        domain: "\u6280\u672F\u6307\u6807",
+        what: "\u6280\u672F\u5206\u6790\uFF1ARSI\u3001MACD\u3001\u5E03\u6797\u5E26\u3001KDJ\u3001ADX\u3001Supertrend \u7B49 17 \u79CD\u6307\u6807 + \u4FE1\u53F7\u89E3\u8BFB",
+        when: ["RSI", "MACD", "\u5E03\u6797\u5E26", "KDJ", "ADX", "\u8D85\u4E70", "\u8D85\u5356", "\u91D1\u53C9", "\u6B7B\u53C9", "\u6280\u672F\u6307\u6807", "\u6307\u6807\u5206\u6790"],
+        go_to: "okx_indicator",
+        go_to_params: "instId, indicator (rsi|macd|bb|atr|stoch \u7B4917\u79CD), period?, bar? (\u9ED8\u8BA41H)",
+        also: [
+          "okx_indicator \u2014 \u5355\u6307\u6807\u8BA1\u7B97+\u4FE1\u53F7\u89E3\u8BFB",
+          "okx_indicator_batch \u2014 \u591A\u6307\u6807\u6279\u91CF+\u7EFC\u5408\u4FE1\u53F7\uFF082\u4E2A\u5DE5\u5177\u4E92\u5907\uFF09",
+          "okx_get_candles \u2014 \u539F\u59CBK\u7EBF\u6570\u636E"
+        ],
+        risk: "READ",
+        authRequired: false
+      },
+      {
+        domain: "\u6A21\u62DF\u4F30\u7B97",
+        what: "\u4E0D\u4EA7\u751F\u771F\u5B9E\u8BA2\u5355\uFF0C\u9884\u4F30\u6210\u4EA4\u4EF7\u3001\u6ED1\u70B9\u3001\u624B\u7EED\u8D39\u3001\u4FDD\u8BC1\u91D1",
+        when: ["\u5982\u679C\u4E70\u5165", "\u5982\u679C\u5356\u51FA", "\u6A21\u62DF", "\u9884\u4F30", "\u6C99\u76D2", "\u8BD5\u7B97", "\u4F1A\u600E\u6837"],
+        go_to: "agent_simulate_order",
+        go_to_params: "instId, side (buy|sell), sz, tdMode (cash|cross|isolated), px?",
+        also: [
+          "okx_preflight_check \u2014 \u4E0B\u5355\u524D\u53C2\u6570\u6821\u9A8C",
+          "okx_position_builder \u2014 \u7EC4\u5408\u4FDD\u8BC1\u91D1\u8BD5\u7B97",
+          "agent_quick_trade \u2014 \u786E\u8BA4\u540E\u771F\u5B9E\u4E0B\u5355\uFF08WRITE\uFF0C\u9700Key\uFF09"
+        ],
+        risk: "READ",
+        authRequired: false
+      },
+      {
+        domain: "WebSocket \u5B9E\u65F6",
+        what: "\u5B9E\u65F6\u884C\u60C5\u63A8\u9001\u3001\u7206\u4ED3\u6D41\u3001\u4EF7\u5DEE/\u5927\u5B97\u6570\u636E\uFF08\u516C\u5F00\u9891\u9053 33 \u4E2A\uFF09",
+        when: ["\u5B9E\u65F6", "\u8BA2\u9605", "\u63A8\u9001", "websocket", "ws", "\u76D1\u542C", "\u7206\u4ED3", "\u5B9E\u65F6\u884C\u60C5"],
+        go_to: "okx_ws_subscribe",
+        go_to_params: "instId (\u4EA7\u54C1ID), channel (33\u4E2A\u516C\u5F00\u9891\u9053)",
+        also: [
+          "okx_ws_subscribe_private \u2014 \u79C1\u6709\u9891\u9053\uFF08\u8D26\u6237/\u6301\u4ED3/\u8BA2\u5355\uFF0C\u9700Key\uFF09",
+          "okx_ws_events \u2014 \u62C9\u53D6\u7F13\u51B2\u4E8B\u4EF6",
+          "okx_ws_status \u2014 \u67E5\u770B\u8BA2\u9605\u72B6\u6001",
+          "okx_ws_close \u2014 \u5173\u95ED\u8BA2\u9605"
+        ],
+        risk: "READ",
+        authRequired: false
+      },
+      {
+        domain: "\u4EE3\u7801\u667A\u80FD",
+        what: "\u67E5\u8BE2 hvip-mcp \u81EA\u8EAB\u4EE3\u7801\u7ED3\u6784\uFF1A\u51FD\u6570\u8C03\u7528\u94FE\u3001\u6A21\u5757\u4F9D\u8D56\u3001\u7B26\u53F7\u641C\u7D22",
+        when: ["\u4EE3\u7801\u7ED3\u6784", "\u8C03\u7528\u94FE", "\u8C01\u8C03\u7528\u4E86", "\u8C01\u88AB\u8C03\u7528", "\u4F9D\u8D56\u5173\u7CFB", "\u4E0A\u4E0B\u6E38", "\u4EE3\u7801\u641C\u7D22"],
+        go_to: "codegraph_status",
+        go_to_params: "\u65E0\u9700\u53C2\u6570",
+        also: [
+          "codegraph_query \u2014 \u8C03\u7528\u94FE\u8FFD\u8E2A (callers|callees|search|file|impact)"
+        ],
+        risk: "READ",
+        authRequired: false
+      },
+      {
+        domain: "\u7CFB\u7EDF\u5DE5\u5177",
+        what: "\u504F\u597D\u8BBE\u7F6E\u3001\u53CD\u9988\u7559\u8A00\u3001Agent\u96C6\u7FA4\u7BA1\u7406\u3001X Layer \u94FE\u4E0A\u4EA4\u4E92",
+        when: ["\u504F\u597D", "\u8BBE\u7F6E\u9ED8\u8BA4", "\u8BB0\u4F4F", "\u53CD\u9988", "\u5EFA\u8BAE", "Agent Hub", "\u96C6\u7FA4"],
+        go_to: "agent_get_preference",
+        go_to_params: "key? (\u4E0D\u586B\u8FD4\u56DE\u5168\u90E8)",
+        also: [
+          "agent_set_preference \u2014 \u4FDD\u5B58\u504F\u597D",
+          "okx_agent_feedback \u2014 \u63D0\u4EA4\u4F7F\u7528\u53CD\u9988",
+          "agent_hub_status \u2014 Agent \u96C6\u7FA4\u72B6\u6001",
+          "agent_hub_dispatch \u2014 \u6D3E\u53D1\u4EFB\u52A1",
+          "agent_room_send \u2014 \u623F\u95F4\u6D88\u606F",
+          "xlayer_subscribe \u2014 X Layer \u94FE\u4E0A\u4E8B\u4EF6",
+          "xlayer_call \u2014 X Layer \u5408\u7EA6\u8C03\u7528\uFF08WRITE\uFF09"
+        ],
+        risk: "READ",
+        authRequired: false
+      },
+      // ═══════════════════ 以下需要 API Key ═══════════════════
+      {
+        domain: "\u8D26\u6237\u8D44\u4EA7",
+        what: "\u67E5\u770B\u8D26\u6237\u4F59\u989D\u3001\u6301\u4ED3\u3001\u914D\u7F6E\u3001\u624B\u7EED\u8D39\u3001\u4F30\u503C",
+        when: ["\u6211\u7684\u8D26\u6237", "\u6301\u4ED3", "\u4F59\u989D", "\u4FDD\u8BC1\u91D1", "\u6760\u6746\u500D\u6570", "\u8D44\u4EA7\u4F30\u503C", "\u624B\u7EED\u8D39\u7387", "\u8D26\u6237\u914D\u7F6E"],
+        go_to: "okx_account_overview",
+        go_to_params: "\u65E0\u9700\u53C2\u6570",
+        also: [
+          "okx_get_balance \u2014 \u5404\u5E01\u79CD\u4F59\u989D\u660E\u7EC6",
+          "okx_get_positions \u2014 \u6301\u4ED3\u8BE6\u60C5\uFF08\u542B\u5E73\u4ED3\u4E0A\u4E0B\u6587 _actionContext\uFF09",
+          "okx_get_account_config \u2014 \u8D26\u6237\u6A21\u5F0F/\u6301\u4ED3\u6A21\u5F0F",
+          "okx_get_asset_valuation \u2014 \u603B\u8D44\u4EA7\u4F30\u503C",
+          "okx_get_fee_rates \u2014 \u624B\u7EED\u8D39\u7387",
+          "okx_get_leverage_info \u2014 \u5F53\u524D\u6760\u6746\u500D\u6570",
+          "okx_get_max_size \u2014 \u6700\u5927\u53EF\u5F00\u6570\u91CF",
+          "okx_set_leverage \u2014 \u8C03\u6574\u6760\u6746\uFF08WRITE\uFF0C\u9700\u786E\u8BA4\uFF09"
+        ],
+        risk: "READ",
+        authRequired: true
       },
       {
         domain: "\u4E0B\u5355\u4EA4\u6613",
         what: "\u4E0B\u5355\u3001\u64A4\u5355\u3001\u6539\u5355\u3001\u5E73\u4ED3",
         when: ["\u4E70\u5165", "\u5356\u51FA", "\u4E0B\u5355", "\u5F00\u4ED3", "\u5E73\u4ED3", "\u64A4\u5355", "\u6539\u5355", "\u6302\u5355"],
         go_to: "agent_quick_trade",
+        go_to_params: "instId, side (buy|sell), sz, tdMode (cash|cross|isolated), px?, ordType? (market|limit)",
         also: [
           "okx_preflight_check \u2014 \u4E0B\u5355\u524D\u9884\u68C0\uFF08\u6570\u91CF/\u9650\u4EF7/\u5408\u7EA6\u6362\u7B97\uFF09",
           "agent_simulate_order \u2014 \u6A21\u62DF\u4E0B\u5355\uFF08\u4E0D\u4EA7\u751F\u771F\u5B9E\u8BA2\u5355\uFF09",
@@ -34891,13 +34984,15 @@ function registerAgentUtils(server, auth) {
           "okx_batch_cancel_orders \u2014 \u6279\u91CF\u64A4\u5355\uFF08WRITE\uFF09",
           "okx_amend_batch_orders \u2014 \u6279\u91CF\u6539\u5355\uFF08WRITE\uFF09"
         ],
-        risk: "WRITE"
+        risk: "WRITE",
+        authRequired: true
       },
       {
         domain: "\u98CE\u9669\u98CE\u63A7",
         what: "\u6301\u4ED3\u98CE\u9669\u8BC4\u4F30\u3001\u5F3A\u5E73\u9884\u8B66\u3001\u4FDD\u8BC1\u91D1\u7387",
         when: ["\u98CE\u9669", "\u7206\u4ED3", "\u5F3A\u5E73", "\u4FDD\u8BC1\u91D1\u7387", "\u5065\u5EB7\u5EA6", "\u98CE\u63A7", "\u4F1A\u4E0D\u4F1A\u7206"],
         go_to: "agent_risk_overview",
+        go_to_params: "\u65E0\u9700\u53C2\u6570",
         also: [
           "okx_get_account_position_risk \u2014 \u8D26\u6237\u6301\u4ED3\u98CE\u9669\u8BE6\u60C5",
           "okx_get_risk_state \u2014 \u8D26\u6237\u98CE\u63A7\u72B6\u6001",
@@ -34905,38 +35000,30 @@ function registerAgentUtils(server, auth) {
           "okx_get_margin_balance \u2014 \u4FDD\u8BC1\u91D1\u4F59\u989D",
           "agent_quick_trade \u2014 \u98CE\u63A7\u544A\u8B66\u540E\u5E73\u4ED3\uFF08WRITE\uFF09"
         ],
-        risk: "READ"
-      },
-      {
-        domain: "\u5E02\u573A\u626B\u63CF",
-        what: "\u53D1\u73B0\u5E02\u573A\u673A\u4F1A\u3001\u6DA8\u5E45\u699C\u3001\u8DCC\u5E45\u699C\u3001\u8D44\u91D1\u8D39\u7387\u5F02\u5E38",
-        when: ["\u4ECA\u5929\u6709\u4EC0\u4E48\u673A\u4F1A", "\u6DA8\u5E45\u699C", "\u8DCC\u5E45\u699C", "\u4EC0\u4E48\u5728\u6DA8", "\u4EC0\u4E48\u5728\u8DCC", "\u5F02\u52A8", "\u626B\u63CF"],
-        go_to: "agent_market_scan",
-        also: [
-          "okx_quick_market \u2014 \u6DF1\u5165\u770B\u67D0\u4E2A\u54C1\u79CD",
-          "okx_get_funding_rate \u2014 \u6C38\u7EED\u5408\u7EA6\u8D44\u91D1\u8D39\u7387",
-          "okx_get_tickers \u2014 \u5168\u5E02\u573A\u884C\u60C5"
-        ],
-        risk: "READ"
+        risk: "READ",
+        authRequired: true
       },
       {
         domain: "\u76C8\u4E8F\u590D\u76D8",
         what: "\u8BA1\u7B97\u5DF2\u5B9E\u73B0/\u672A\u5B9E\u73B0\u76C8\u4E8F\u3001\u4EA4\u6613\u7EE9\u6548",
         when: ["\u8D5A\u4E86\u591A\u5C11", "\u4E8F\u4E86\u591A\u5C11", "\u76C8\u4E8F", "\u7EE9\u6548", "\u590D\u76D8", "PnL", "\u6536\u76CA"],
         go_to: "agent_pnl_report",
+        go_to_params: "days? (\u9ED8\u8BA47)",
         also: [
           "okx_get_positions \u2014 \u5F53\u524D\u6D6E\u52A8\u76C8\u4E8F",
           "okx_get_orders_history \u2014 \u5386\u53F2\u8BA2\u5355\u76C8\u4E8F",
           "okx_get_positions_history \u2014 \u5386\u53F2\u5E73\u4ED3\u76C8\u4E8F",
           "okx_get_fills \u2014 \u6210\u4EA4\u660E\u7EC6"
         ],
-        risk: "READ"
+        risk: "READ",
+        authRequired: true
       },
       {
         domain: "\u8D44\u91D1\u7BA1\u7406",
         what: "\u5212\u8F6C\u3001\u63D0\u73B0\u3001\u5145\u503C\u3001\u5151\u6362",
         when: ["\u5212\u8F6C", "\u63D0\u73B0", "\u5145\u503C", "\u8F6C\u8D26", "\u5151\u6362", "\u95EA\u5151", "\u51FA\u5165\u91D1", "deposit", "withdraw"],
         go_to: "okx_get_balance",
+        go_to_params: "ccy? (\u5982 BTC\uFF0C\u4E0D\u586B\u5168\u90E8)",
         also: [
           "okx_transfer \u2014 \u8D44\u91D1\u5212\u8F6C\uFF08WRITE\uFF0C\u9700\u786E\u8BA4\uFF09",
           "okx_withdrawal \u2014 \u63D0\u73B0\uFF08WRITE\uFF0C\u9700\u786E\u8BA4\uFF09",
@@ -34948,13 +35035,15 @@ function registerAgentUtils(server, auth) {
           "okx_get_currencies \u2014 \u94FE\u4E0A\u5E01\u79CD\u4FE1\u606F",
           "okx_get_funding_balance \u2014 \u8D44\u91D1\u8D26\u6237\u4F59\u989D"
         ],
-        risk: "FUND_TRANSFER"
+        risk: "FUND_TRANSFER",
+        authRequired: true
       },
       {
         domain: "\u7B56\u7565\u4EA4\u6613",
         what: "\u7F51\u683C\u3001\u8DDF\u5355\u3001\u4FE1\u53F7\u3001\u7B56\u7565\u59D4\u6258\u3001\u4EF7\u5DEE\u3001RFQ",
         when: ["\u7F51\u683C", "\u8DDF\u5355", "\u4FE1\u53F7", "\u7B56\u7565", "\u5B9A\u6295", "\u4EF7\u5DEE", "\u5927\u5B97", "RFQ"],
         go_to: "okx_get_grid_ai_param",
+        go_to_params: "instType (SPOT|SWAP|FUTURES), algoOrdType (grid|contract_grid|recurring_buy|twap|iceberg)",
         also: [
           "okx_create_grid_order \u2014 \u521B\u5EFA\u7F51\u683C\uFF08WRITE\uFF0C\u9700\u786E\u8BA4\uFF09",
           "okx_stop_grid_order \u2014 \u505C\u6B62\u7F51\u683C",
@@ -34967,39 +35056,15 @@ function registerAgentUtils(server, auth) {
           "okx_get_algo_orders \u2014 \u7B56\u7565\u59D4\u6258\u5217\u8868",
           "okx_create_rfq \u2014 \u521B\u5EFA\u5927\u5B97\u8BE2\u4EF7\uFF08WRITE\uFF09"
         ],
-        risk: "WRITE"
-      },
-      {
-        domain: "\u9884\u6D4B\u5E02\u573A",
-        what: "\u4E8B\u4EF6\u5408\u7EA6\u3001\u9884\u6D4B\u5E02\u573A\u4EA4\u6613",
-        when: ["\u9884\u6D4B\u5E02\u573A", "\u4E8B\u4EF6\u5408\u7EA6", "outcomes", "predictions", "\u5BF9\u8D4C"],
-        go_to: "okx_event_instruments",
-        also: [
-          "okx_event_place_order \u2014 \u4E8B\u4EF6\u5408\u7EA6\u4E0B\u5355\uFF08WRITE\uFF09",
-          "okx_event_fills \u2014 \u4E8B\u4EF6\u5408\u7EA6\u6210\u4EA4",
-          "okx_predictions_positions \u2014 \u9884\u6D4B\u5E02\u573A\u6301\u4ED3",
-          "okx_predictions_order_list \u2014 \u9884\u6D4B\u5E02\u573A\u8BA2\u5355",
-          "okx_predictions_redeem \u2014 \u9884\u6D4B\u5E02\u573A\u8D4E\u56DE\uFF08WRITE\uFF09"
-        ],
-        risk: "READ"
-      },
-      {
-        domain: "\u6280\u672F\u6307\u6807",
-        what: "\u6280\u672F\u5206\u6790\u6307\u6807\u8BA1\u7B97\uFF1ARSI\u3001MACD\u3001\u5E03\u6797\u5E26\u3001ADX\u3001Supertrend \u7B49 17 \u79CD\u6307\u6807",
-        when: ["RSI", "MACD", "\u5E03\u6797\u5E26", "KDJ", "ADX", "\u8D85\u4E70", "\u8D85\u5356", "\u91D1\u53C9", "\u6B7B\u53C9", "\u6280\u672F\u6307\u6807", "\u6307\u6807\u5206\u6790"],
-        go_to: "okx_indicator",
-        also: [
-          "okx_indicator \u2014 \u5355\u6307\u6807\u8BA1\u7B97+\u4FE1\u53F7\u89E3\u8BFB",
-          "okx_indicator_batch \u2014 \u591A\u6307\u6807\u6279\u91CF+\u7EFC\u5408\u4FE1\u53F7",
-          "okx_get_candles \u2014 \u539F\u59CBK\u7EBF\u6570\u636E"
-        ],
-        risk: "READ"
+        risk: "WRITE",
+        authRequired: true
       },
       {
         domain: "\u806A\u660E\u94B1",
         what: "\u4EA4\u6613\u5458\u6392\u884C\u699C\u3001\u806A\u660E\u94B1\u6D41\u5411\u3001\u5E02\u573A\u60C5\u7EEA\u5206\u6790",
         when: ["\u4EA4\u6613\u5458", "\u6392\u884C\u699C", "\u806A\u660E\u94B1", "\u8DDF\u8C01\u8D5A\u94B1", "\u60C5\u7EEA", "\u591A\u7A7A\u6BD4", "\u6050\u614C", "smart money"],
         go_to: "okx_smart_leaderboard",
+        go_to_params: "instType? (SPOT|SWAP), sortBy? (pnl|winRate|sharpe), topN?",
         also: [
           "okx_smart_leaderboard \u2014 \u4EA4\u6613\u5458\u6392\u884C\u699C",
           "okx_smart_trader_detail \u2014 \u5355\u4EA4\u6613\u5458\u6DF1\u5EA6\u5206\u6790",
@@ -35007,58 +35072,26 @@ function registerAgentUtils(server, auth) {
           "okx_get_lead_trader_positions \u2014 \u4EA4\u6613\u5458\u5F53\u524D\u6301\u4ED3",
           "okx_get_lead_trader_stats \u2014 \u4EA4\u6613\u5458\u5386\u53F2\u7EDF\u8BA1"
         ],
-        risk: "READ"
+        risk: "READ",
+        authRequired: true
       },
       {
-        domain: "WebSocket \u5B9E\u65F6",
-        what: "\u5B9E\u65F6\u884C\u60C5\u3001\u8D26\u6237\u3001\u8BA2\u5355\u3001\u7206\u4ED3\u3001\u4EF7\u5DEE\u3001\u5927\u5B97\u63A8\u9001\uFF0855 \u9891\u9053\uFF09",
-        when: ["\u5B9E\u65F6", "\u8BA2\u9605", "\u63A8\u9001", "websocket", "ws", "\u76D1\u542C", "\u7206\u4ED3", "\u5B9E\u65F6\u8BA2\u5355"],
-        go_to: "okx_ws_subscribe",
-        also: [
-          "okx_ws_subscribe_private \u2014 \u79C1\u6709\u9891\u9053\uFF08\u8D26\u6237/\u6301\u4ED3/\u8BA2\u5355\uFF0C\u9700Key\uFF09",
-          "okx_ws_events \u2014 \u62C9\u53D6\u7F13\u51B2\u4E8B\u4EF6",
-          "okx_ws_status \u2014 \u67E5\u770B\u8BA2\u9605\u72B6\u6001",
-          "okx_ws_close \u2014 \u5173\u95ED\u8BA2\u9605"
-        ],
-        risk: "READ"
-      },
-      {
-        domain: "\u6A21\u62DF\u4F30\u7B97",
-        what: "\u4E0D\u4EA7\u751F\u771F\u5B9E\u8BA2\u5355\uFF0C\u9884\u4F30\u6210\u4EA4\u4EF7\u3001\u6ED1\u70B9\u3001\u624B\u7EED\u8D39",
-        when: ["\u5982\u679C\u4E70\u5165", "\u5982\u679C\u5356\u51FA", "\u6A21\u62DF", "\u9884\u4F30", "\u6C99\u76D2", "\u8BD5\u7B97", "\u4F1A\u600E\u6837"],
-        go_to: "agent_simulate_order",
-        also: [
-          "agent_quick_trade \u2014 \u786E\u8BA4\u540E\u771F\u5B9E\u4E0B\u5355\uFF08WRITE\uFF09",
-          "okx_preflight_check \u2014 \u4E0B\u5355\u524D\u53C2\u6570\u6821\u9A8C",
-          "okx_position_builder \u2014 \u7EC4\u5408\u4FDD\u8BC1\u91D1\u8BD5\u7B97"
-        ],
-        risk: "READ"
-      },
-      {
-        domain: "\u4EE3\u7801\u667A\u80FD",
-        what: "\u67E5\u8BE2 hvip-mcp \u81EA\u8EAB\u4EE3\u7801\u7ED3\u6784\uFF1A\u51FD\u6570\u8C03\u7528\u94FE\u3001\u6A21\u5757\u4F9D\u8D56\u3001\u7B26\u53F7\u641C\u7D22",
-        when: ["\u4EE3\u7801\u7ED3\u6784", "\u8C03\u7528\u94FE", "\u8C01\u8C03\u7528\u4E86", "\u8C01\u88AB\u8C03\u7528", "\u4F9D\u8D56\u5173\u7CFB", "\u4E0A\u4E0B\u6E38", "\u4EE3\u7801\u641C\u7D22"],
-        go_to: "codegraph_status",
-        also: [
-          "codegraph_query \u2014 \u8C03\u7528\u94FE\u8FFD\u8E2A (callers/callees/explore/files)"
-        ],
-        risk: "READ"
-      },
-      {
-        domain: "\u7CFB\u7EDF\u5DE5\u5177",
-        what: "\u504F\u597D\u8BBE\u7F6E\u3001\u53CD\u9988\u7559\u8A00\u3001Agent\u96C6\u7FA4\u7BA1\u7406",
-        when: ["\u504F\u597D", "\u8BBE\u7F6E\u9ED8\u8BA4", "\u8BB0\u4F4F", "\u53CD\u9988", "\u5EFA\u8BAE", "Agent Hub", "\u96C6\u7FA4"],
-        go_to: "agent_get_preference",
+        domain: "\u9884\u6D4B\u5E02\u573A",
+        what: "\u4E8B\u4EF6\u5408\u7EA6\u3001\u9884\u6D4B\u5E02\u573A\u4EA4\u6613\uFF08\u516C\u5F00\u67E5\u8BE2 + \u9700Key\u4EA4\u6613\uFF09",
+        when: ["\u9884\u6D4B\u5E02\u573A", "\u4E8B\u4EF6\u5408\u7EA6", "outcomes", "predictions", "\u5BF9\u8D4C"],
+        go_to: "okx_event_instruments",
+        go_to_params: "eventType? (\u4E0D\u586B\u8FD4\u56DE\u5168\u90E8)",
         also: [
-          "agent_set_preference \u2014 \u4FDD\u5B58\u504F\u597D",
-          "okx_agent_feedback \u2014 \u63D0\u4EA4\u4F7F\u7528\u53CD\u9988",
-          "agent_hub_status \u2014 Agent \u96C6\u7FA4\u72B6\u6001",
-          "agent_hub_dispatch \u2014 \u6D3E\u53D1\u4EFB\u52A1",
-          "agent_room_send \u2014 \u623F\u95F4\u6D88\u606F",
-          "xlayer_subscribe \u2014 X Layer \u94FE\u4E0A\u4E8B\u4EF6",
-          "xlayer_call \u2014 X Layer \u5408\u7EA6\u8C03\u7528\uFF08WRITE\uFF09"
+          "okx_predictions_ticker \u2014 \u9884\u6D4B\u5E02\u573A\u884C\u60C5\uFF08\u516C\u5F00\uFF09",
+          "okx_predictions_orderbook \u2014 \u9884\u6D4B\u5E02\u573A\u6DF1\u5EA6\uFF08\u516C\u5F00\uFF09",
+          "okx_event_place_order \u2014 \u4E8B\u4EF6\u5408\u7EA6\u4E0B\u5355\uFF08WRITE\uFF0C\u9700Key\uFF09",
+          "okx_event_fills \u2014 \u4E8B\u4EF6\u5408\u7EA6\u6210\u4EA4\uFF08\u9700Key\uFF09",
+          "okx_predictions_positions \u2014 \u9884\u6D4B\u5E02\u573A\u6301\u4ED3\uFF08\u9700Key\uFF09",
+          "okx_predictions_order_list \u2014 \u9884\u6D4B\u5E02\u573A\u8BA2\u5355\uFF08\u9700Key\uFF09",
+          "okx_predictions_redeem \u2014 \u9884\u6D4B\u5E02\u573A\u8D4E\u56DE\uFF08WRITE\uFF0C\u9700Key\uFF09"
         ],
-        risk: "READ"
+        risk: "READ",
+        authRequired: true
       }
     ],
     _tips: [
@@ -35067,7 +35100,7 @@ function registerAgentUtils(server, auth) {
       "\u5148\u6A21\u62DF\u540E\u4EA4\u6613: agent_simulate_order \u9884\u4F30 -> \u786E\u8BA4 -> agent_quick_trade \u4E0B\u5355",
       "WRITE \u5DE5\u5177\u4F1A\u4FEE\u6539\u8D26\u6237\uFF0C\u8C03\u7528\u524D\u5FC5\u987B\u5411\u7528\u6237\u786E\u8BA4\uFF0C\u4E0D\u53EF\u81EA\u52A8\u53D1\u8D77",
       "\u6280\u672F\u6307\u6807\u7528 okx_indicator \u5355\u4E2A\u8BA1\u7B97\u6216 okx_indicator_batch \u6279\u91CF\uFF0C\u652F\u6301 RSI/MACD/\u5E03\u6797\u5E26\u7B49 17 \u79CD",
-      "\u806A\u660E\u94B1\u5206\u6790\u7528 okx_smart_leaderboard \u627E\u9876\u5C16\u4EA4\u6613\u5458 \u2192 okx_smart_sentiment \u770B\u5E02\u573A\u60C5\u7EEA"
+      "\u65E0 Key \u60F3\u770B\u76D8: okx_quick_market \u770B\u884C\u60C5 + okx_indicator \u770B\u6307\u6807 + agent_market_scan \u626B\u5E02\u573A"
     ]
   };
   registerTool(
@@ -35093,38 +35126,15 @@ function registerAgentUtils(server, auth) {
           setup.whatYouCanDoNow = "\u5F53\u524D\u65E0 API Key\uFF0C\u4F46\u4EE5\u4E0B\u57DF\u7684\u5DE5\u5177\u53EF\u7ACB\u5373\u4F7F\u7528: \u884C\u60C5\u770B\u76D8 / \u6280\u672F\u6307\u6807 / \u5E02\u573A\u626B\u63CF / \u806A\u660E\u94B1 / \u9884\u6D4B\u5E02\u573A\uFF08\u516C\u5F00\u67E5\u8BE2\uFF09/ WebSocket \u5B9E\u65F6 / \u7CFB\u7EDF\u5DE5\u5177";
         }
         const onboarding = hasAuth ? "API Key \u5DF2\u914D\u7F6E\u3002\u5EFA\u8BAE\u7B2C\u4E00\u6B65: agent_get_preference \u6062\u590D\u504F\u597D -> okx_account_overview \u4E86\u89E3\u8D26\u6237\u5168\u666F -> \u6839\u636E\u7528\u6237\u610F\u56FE\u5339\u914D\u57DF go_to \u5DE5\u5177" : "\u6B22\u8FCE\uFF01hvip MCP \u5DF2\u8FDE\u63A5\u4F46\u5C1A\u672A\u914D\u7F6E API Key\u3002\u544A\u8BC9\u7528\u6237\uFF1A\u60F3\u770B\u884C\u60C5\u548C\u6307\u6807\u73B0\u5728\u5C31\u80FD\u770B\uFF0C\u60F3\u770B\u8D26\u6237\u548C\u4EA4\u6613\u8BF7\u5148\u914D Key\u3002\u914D\u597D\u540E\u91CD\u8FDE MCP \u5373\u53EF\u3002";
-        const paramsHints = {
-          "okx_account_overview": "\u65E0\u9700\u53C2\u6570",
-          "okx_quick_market": "instId (\u5982 BTC-USDT\u3001ETH-USDT-SWAP)",
-          "okx_preflight_check": "instId, tdMode (cash|cross|isolated), sz, px?, side?, ordType?",
-          "agent_quick_trade": "instId, side (buy|sell), sz, tdMode (cash|cross|isolated), px?, ordType?",
-          "agent_risk_overview": "\u65E0\u9700\u53C2\u6570",
-          "agent_market_scan": "instType? (\u9ED8\u8BA4SWAP), topN?, sortBy? (change|vol|fundingRate)",
-          "agent_pnl_report": "days? (\u9ED8\u8BA47)",
-          "okx_get_balance": "ccy? (\u5982 BTC\uFF0C\u4E0D\u586B\u5168\u90E8)",
-          "agent_simulate_order": "instId, side, sz, tdMode, px?",
-          "okx_indicator": "instId, indicator (rsi|macd|bb|atr|stoch \u7B4917\u79CD), period?, bar? (\u9ED8\u8BA41H)",
-          "okx_indicator_batch": "instId, indicators (\u9017\u53F7\u5206\u9694\u5982 rsi,macd,bb), bar?",
-          "okx_smart_leaderboard": "instType?, sortBy?, topN?",
-          "okx_smart_trader_detail": "uniqueCode (\u4EA4\u6613\u5458\u7801), instType?",
-          "okx_smart_sentiment": "instFamily? (\u9ED8\u8BA4BTC-USD)",
-          "agent_get_preference": "key? (\u4E0D\u586B\u8FD4\u56DE\u5168\u90E8)",
-          "agent_set_preference": "key, value",
-          "okx_event_instruments": "eventType? (\u4E0D\u586B\u8FD4\u56DE\u5168\u90E8)",
-          "okx_ws_subscribe": "instId (\u4EA7\u54C1ID), channel (33\u4E2A\u516C\u5F00\u9891\u9053)",
-          "okx_ws_subscribe_private": "instId? (\u4EA7\u54C1ID), channel (22\u4E2A\u79C1\u6709\u9891\u9053\uFF0C\u9700Key)",
-          "okx_get_grid_ai_param": "instType, algoOrdType"
-        };
-        const enrichedDomains = CATALOG.domains.map((d) => ({
-          ...d,
-          go_to_params: paramsHints[d.go_to] || "\u89C1 agent_catalog_detail"
-        }));
+        const publicDomains = CATALOG.domains.filter((d) => !d.authRequired);
+        const authDomains = CATALOG.domains.filter((d) => d.authRequired);
         return toResult({
           tsIso: (/* @__PURE__ */ new Date()).toISOString(),
           _setup: setup,
           _onboarding: onboarding,
           _instruction: CATALOG._instruction,
-          domains: enrichedDomains,
+          publicDomains,
+          authDomains: hasAuth ? authDomains : authDomains.map((d) => ({ ...d, _disabled: "\u9700\u8981 API Key \u624D\u80FD\u4F7F\u7528\u6B64\u57DF" })),
           _tips: CATALOG._tips
         });
       } catch (e) {
@@ -35369,6 +35379,7 @@ function registerAgentUtils(server, auth) {
     async ({ domain }) => {
       try {
         const detail = DOMAIN_DETAILS[domain];
+        const hasAuth = auth !== null;
         if (!detail) {
           return toResult({
             found: false,
@@ -35378,9 +35389,14 @@ function registerAgentUtils(server, auth) {
             tsIso: (/* @__PURE__ */ new Date()).toISOString()
           });
         }
+        const needsKey = detail.authRequired && !hasAuth;
         return toResult({
           found: true,
           domain,
+          authRequired: detail.authRequired,
+          keyAvailable: hasAuth,
+          usable: !detail.authRequired || hasAuth,
+          _authWarning: needsKey ? "\u26A0\uFE0F \u6B64\u57DF\u9700\u8981 API Key\uFF0C\u5F53\u524D\u672A\u914D\u7F6E\u3002\u544A\u8BC9\u7528\u6237\u53BB OKX \u5B98\u7F51\u521B\u5EFA Key \u540E\u91CD\u8FDE\u3002" : null,
           ...detail,
           tsIso: (/* @__PURE__ */ new Date()).toISOString()
         });
@@ -37980,6 +37996,50 @@ function resolveTransportMode() {
   if (arg === "start:stdio" || arg === "" || arg.startsWith("-")) return "stdio";
   return "stdio";
 }
+function printHelpAndExit(version2) {
+  process.stdout.write([
+    ``,
+    `  hvip-mcp v${version2} \u2014 OKX MCP \u670D\u52A1\u5668\uFF08\u975E OKX \u5B98\u65B9\u4EA7\u54C1\uFF09`,
+    ``,
+    `  \u{1F517} \u4ED3\u5E93: https://github.com/okx-wallet-H/hvip-mcp`,
+    ``,
+    `  \u26A0\uFE0F  \u8FD9\u4E0D\u662F\u547D\u4EE4\u884C\u5DE5\u5177\uFF0C\u800C\u662F MCP (Model Context Protocol) \u670D\u52A1\u5668\u3002`,
+    `  \u4F60\u4E0D\u80FD\u76F4\u63A5\u5728\u7EC8\u7AEF\u91CC\u8FD0\u884C\u5B83\u2014\u2014\u9700\u8981\u914D\u7F6E\u5230 MCP \u5BA2\u6237\u7AEF\uFF08Claude Desktop\u3001VS Code\u3001Cline \u7B49\uFF09\u4E2D\u3002`,
+    ``,
+    `  \u2500\u2500 \u5FEB\u901F\u5F00\u59CB \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`,
+    ``,
+    `  Claude Desktop\uFF08\u63A8\u8350\uFF09:`,
+    `    1. \u6253\u5F00 Claude Desktop \u2192 \u8BBE\u7F6E \u2192 Developer \u2192 Edit Config`,
+    `    2. \u5728 mcpServers \u4E2D\u6DFB\u52A0:`,
+    ``,
+    `       {`,
+    `         "hvip": {`,
+    `           "command": "npx",`,
+    `           "args": ["-y", "hvip-mcp-server"]`,
+    `         }`,
+    `       }`,
+    ``,
+    `  VS Code / Cline:`,
+    `    \u5728 MCP \u914D\u7F6E\u4E2D\u6DFB\u52A0\u540C\u6837\u7684 JSON\u3002`,
+    ``,
+    `  \u2500\u2500 \u53EF\u7528\u53C2\u6570 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`,
+    ``,
+    `  npx hvip-mcp-server              \u542F\u52A8 MCP stdio \u670D\u52A1\u5668`,
+    `  npx hvip-mcp-server start:http   \u542F\u52A8 HTTP \u6A21\u5F0F (localhost:3000)`,
+    `  npx hvip-mcp-server --help       \u663E\u793A\u6B64\u5E2E\u52A9`,
+    `  npx hvip-mcp-server --version    \u663E\u793A\u7248\u672C\u53F7`,
+    ``,
+    `  \u2500\u2500 \u73AF\u5883\u53D8\u91CF \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`,
+    ``,
+    `  OKX_API_KEY       API Key\uFF08\u83B7\u53D6\uFF1AOKX \u5B98\u7F51 \u2192 \u4E2A\u4EBA\u4E2D\u5FC3 \u2192 API\uFF09`,
+    `  OKX_SECRET_KEY     Secret Key`,
+    `  OKX_PASSPHRASE     Passphrase`,
+    `  PORT=3000          HTTP \u6A21\u5F0F\u7AEF\u53E3\uFF08\u9ED8\u8BA4 3000\uFF09`,
+    `  HOST=127.0.0.1     HTTP \u6A21\u5F0F\u7ED1\u5B9A\u5730\u5740`,
+    ``
+  ].join("\n") + "\n");
+  process.exit(0);
+}
 function registerAllTools(server, auth, readOnly) {
   let skipped = 0;
   const skipLog = [];
@@ -38152,7 +38212,14 @@ async function startStdio(server, version2, auth, readOnly, skipped, skipLog) {
   await server.connect(transport);
 }
 async function main() {
-  const VERSION = "0.2.53";
+  const VERSION = "0.2.55";
+  const argv = process.argv.slice(2);
+  if (argv.includes("--help") || argv.includes("-h")) printHelpAndExit(VERSION);
+  if (argv.includes("--version") || argv.includes("-v")) {
+    process.stdout.write(`hvip-mcp v${VERSION}
+`);
+    process.exit(0);
+  }
   const auth = getAuth();
   const mode = resolveTransportMode();
   const exec = resolveExecutionMode();
@@ -38166,6 +38233,11 @@ async function main() {
   if (mode === "http") {
     await startHttp(server, VERSION, auth, readOnly, skipped);
   } else {
+    if (process.stdin.isTTY && process.env.NODE_ENV !== "production") {
+      process.stderr.write("\n[hint] \u68C0\u6D4B\u5230\u4F60\u5728\u7EC8\u7AEF\u76F4\u63A5\u8FD0\u884C hvip-mcp\u3002\n");
+      process.stderr.write("[hint] hvip-mcp \u662F MCP \u670D\u52A1\u5668\uFF0C\u9700\u8981\u5728 MCP \u5BA2\u6237\u7AEF\uFF08\u5982 Claude Desktop\uFF09\u4E2D\u914D\u7F6E\u3002\n");
+      process.stderr.write("[hint] \u8FD0\u884C npx hvip-mcp-server --help \u67E5\u770B\u914D\u7F6E\u65B9\u6CD5\u3002\n\n");
+    }
     await startStdio(server, VERSION, auth, readOnly, skipped, skipLog);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvip-mcp-server",
-  "version": "0.2.53",
+  "version": "0.2.55",
   "description": "hvip MCP Server — 365 工具覆盖 97.7% OKX REST API，含交易/行情/资金/策略/预测市场/技术指标/Smart Money（非 OKX 官方产品）",
   "homepage": "https://github.com/okx-wallet-H/hvip-mcp",
   "repository": {