hvip-mcp-server 0.2.54 → 0.2.56

package/dist/index.js

@@ -35379,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,
@@ -35388,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()
         });
@@ -37017,11 +37023,55 @@ var AgentHub = class {
   rooms = /* @__PURE__ */ new Map();
   heartbeatTimer = null;
   version = "0.0.0";
+  port = 0;
   // ── 启动 ──
   start(port, host = "0.0.0.0", version2 = "0.0.0") {
     this.version = version2;
-    this.wss = new import_websocket_server.default({ port, host });
-    console.log(`[AgentHub] WS Server v${version2} started on ws://${host}:${port}`);
+    const startWss = (p) => {
+      return new Promise((resolve2) => {
+        const wss = new import_websocket_server.default({ port: p, host });
+        let resolved = false;
+        const done = (ok) => {
+          if (!resolved) {
+            resolved = true;
+            resolve2(ok);
+          }
+        };
+        wss.on("listening", () => {
+          this.wss = wss;
+          this.port = p;
+          done(true);
+        });
+        wss.on("error", () => {
+          try {
+            wss.close();
+          } catch {
+          }
+          done(false);
+        });
+        setTimeout(() => done(false), 1e3);
+      });
+    };
+    const ports = [port, port + 1, port + 2];
+    startWss(ports[0]).then((ok) => {
+      if (!ok) return startWss(ports[1]);
+      return true;
+    }).then((ok) => {
+      if (!ok) return startWss(ports[2]);
+      return ok === true ? true : false;
+    }).then((ok) => {
+      if (!ok) {
+        process.stderr.write(`[AgentHub] WS Hub \u8DF3\u8FC7\uFF08\u7AEF\u53E3 ${ports.join("/")} \u4E0D\u53EF\u7528\uFF09
+`);
+        return;
+      }
+      process.stderr.write(`[AgentHub] WS Hub v${version2} ws://${host}:${this.port}
+`);
+      this.setupHub();
+    });
+  }
+  setupHub() {
+    if (!this.wss) return;
     this.ensureRoom("#lobby");
     this.ensureRoom("#review");
     this.wss.on("connection", (ws) => {
@@ -37046,7 +37096,7 @@ var AgentHub = class {
         if (now - a.lastSeen > 12e4) {
           a.ws.close();
           this.agents.delete(id);
-          console.log(`[AgentHub] Agent \u5FC3\u8DF3\u8D85\u65F6: ${id}`);
+          console.log("[AgentHub] Agent \u5FC3\u8DF3\u8D85\u65F6: " + id);
         }
       }
     }, 3e4);
@@ -37990,6 +38040,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 = [];
@@ -38162,7 +38256,14 @@ async function startStdio(server, version2, auth, readOnly, skipped, skipLog) {
   await server.connect(transport);
 }
 async function main() {
-  const VERSION = "0.2.54";
+  const VERSION = "0.2.56";
+  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();
@@ -38176,6 +38277,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.54",
+  "version": "0.2.56",
   "description": "hvip MCP Server — 365 工具覆盖 97.7% OKX REST API，含交易/行情/资金/策略/预测市场/技术指标/Smart Money（非 OKX 官方产品）",
   "homepage": "https://github.com/okx-wallet-H/hvip-mcp",
   "repository": {