hvip-mcp-server 0.2.54 → 0.2.55

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()
         });
@@ -37990,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 = [];
@@ -38162,7 +38212,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.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();
@@ -38176,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.54",
+  "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": {