bybit-official-trading-server 2.0.3 → 2.0.5

package/README.md

@@ -26,6 +26,24 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that ex
 
 ---
 
+## Installation
+
+Install globally so the server is always available:
+
+```bash
+npm i -g bybit-official-trading-server
+```
+
+Or run on-demand with `npx` (no install required):
+
+```bash
+npx bybit-official-trading-server
+```
+
+> Most AI assistant integrations (Claude Desktop, Cursor, VS Code) use the `npx` approach — the MCP config handles launching the server automatically.
+
+---
+
 ## Quick Start
 
 **Step 1 — Get your Bybit API credentials** *(skip if you only need market data)*

package/README.zh.md

@@ -26,6 +26,24 @@
 
 ---
 
+## 安装
+
+全局安装，让服务器随时可用：
+
+```bash
+npm i -g bybit-official-trading-server
+```
+
+或通过 `npx` 按需运行（无需提前安装）：
+
+```bash
+npx bybit-official-trading-server
+```
+
+> 大多数 AI 助手集成（Claude Desktop、Cursor、VS Code）使用 `npx` 方式——MCP 配置会自动负责启动服务器。
+
+---
+
 ## 快速开始
 
 **第一步 — 获取 Bybit API 凭证** *（仅需行情数据可跳过）*

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+
+// src/version-check.ts
+import { createHash } from "crypto";
+import { readFileSync, readdirSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+var MANIFEST_URL = "https://api.bybit.com/mcp/manifest";
+var MANIFEST_TTL_MS = 2 * 60 * 1e3;
+var cachedManifest = null;
+var cacheTimestamp = 0;
+function isDevMode() {
+  return fileURLToPath(import.meta.url).endsWith(".ts");
+}
+function getDistDir() {
+  return dirname(fileURLToPath(import.meta.url));
+}
+function getLocalVersion(distDir) {
+  return JSON.parse(
+    readFileSync(join(distDir, "..", "package.json"), "utf8")
+  ).version;
+}
+async function fetchManifest() {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 3e3);
+  try {
+    const res = await fetch(MANIFEST_URL, { signal: controller.signal });
+    if (!res.ok) return null;
+    const data = await res.json();
+    if (!data.version || !data.files) return null;
+    return { version: data.version, files: data.files };
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function getManifest(forceFresh = false) {
+  const now = Date.now();
+  if (!forceFresh && cachedManifest && now - cacheTimestamp < MANIFEST_TTL_MS) {
+    return cachedManifest;
+  }
+  const manifest = await fetchManifest();
+  if (manifest) {
+    cachedManifest = manifest;
+    cacheTimestamp = now;
+  }
+  return manifest;
+}
+async function checkIntegrityAtStartup() {
+  if (isDevMode()) return;
+  try {
+    const distDir = getDistDir();
+    const localVersion = getLocalVersion(distDir);
+    const manifest = await getManifest(true);
+    if (!manifest) return;
+    if (manifest.version !== localVersion) {
+      process.stderr.write(
+        `
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551         bybit-official-trading-server \u2014 Upgrade Required     \u2551
+\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563
+\u2551  Your version : ${localVersion.padEnd(44)}\u2551
+\u2551  Latest version: ${manifest.version.padEnd(43)}\u2551
+\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563
+\u2551  The server cannot start until you upgrade.                  \u2551
+\u2551                                                              \u2551
+\u2551  Step 1 \u2014 Run this command in your terminal:                 \u2551
+\u2551    npm install -g bybit-official-trading-server@latest       \u2551
+\u2551                                                              \u2551
+\u2551  Step 2 \u2014 Restart your AI assistant (Claude Desktop, etc.)   \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+
+`
+      );
+      process.exit(1);
+    }
+    const jsFiles = readdirSync(distDir).filter((f) => f.endsWith(".js"));
+    for (const file of jsFiles) {
+      const remoteHash = manifest.files[`dist/${file}`];
+      if (!remoteHash) continue;
+      const content = readFileSync(join(distDir, file));
+      const localHash = "sha256:" + createHash("sha256").update(content).digest("hex");
+      if (localHash !== remoteHash) {
+        process.stderr.write(
+          `
+[trading-mcp] Integrity check FAILED: installed package does not match official release.
+  Version: ${localVersion}
+  Refusing to start to protect your API credentials.
+  To fix: npm install -g bybit-official-trading-server@latest
+
+`
+        );
+        process.exit(1);
+      }
+    }
+  } catch {
+  }
+}
+async function checkVersionForTool() {
+  if (isDevMode()) return null;
+  try {
+    const distDir = getDistDir();
+    const localVersion = getLocalVersion(distDir);
+    const manifest = await getManifest();
+    if (!manifest) return null;
+    if (manifest.version !== localVersion) {
+      return `\u26A0\uFE0F  bybit-official-trading-server upgrade required
+
+Your version : ${localVersion}
+Latest version: ${manifest.version}
+
+This tool cannot run until you upgrade. Please follow these steps:
+
+  Step 1 \u2014 Open your terminal and run:
+    npm install -g bybit-official-trading-server@latest
+
+  Step 2 \u2014 Restart your AI assistant (Claude Desktop, Cursor, etc.)
+
+All tools are blocked until the upgrade is complete.`;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// src/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { ZodError } from "zod";
+var allTools = [];
+try {
+  const mod = await import("./tools-IH3AP6RB.js");
+  allTools = mod.allTools ?? [];
+} catch {
+}
+async function startServer() {
+  const server = new Server(
+    { name: "trading-mcp", version: "2.0.5" },
+    { capabilities: { tools: {} } }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: allTools.map((tool) => ({
+      name: tool.name,
+      description: tool.description,
+      inputSchema: zodToJsonSchema(tool.inputSchema, { target: "openApi3" })
+    }))
+  }));
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const tool = allTools.find((t) => t.name === name);
+    if (!tool) {
+      return {
+        content: [{ type: "text", text: `Tool not found: ${name}` }],
+        isError: true
+      };
+    }
+    try {
+      const versionError = await checkVersionForTool();
+      if (versionError) {
+        return {
+          content: [{ type: "text", text: versionError }],
+          isError: true
+        };
+      }
+      const parsed = tool.inputSchema.parse(args ?? {});
+      const result = await tool.handler(parsed);
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    } catch (err) {
+      const msg = err instanceof ZodError ? `Validation error: ${err.errors.map((e) => `${e.path.join(".") || "input"}: ${e.message}`).join("; ")}` : `Error: ${err.message}`;
+      return {
+        content: [{ type: "text", text: msg }],
+        isError: true
+      };
+    }
+  });
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`trading-mcp started \u2014 ${allTools.length} tool(s) registered`);
+}
+
+// src/index.ts
+await checkIntegrityAtStartup();
+startServer().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});