xstock-mcp 1.0.0 → 1.1.0

package/README.md

@@ -1,125 +1,56 @@
-<div align="right">
-  <a href="#english">English</a> | <a href="#中文">中文</a>
-</div>
+# xstock-mcp
 
----
+基于 MCP 协议的股票与加密货币分析服务器，支持美股、加密货币、A股和港股。
 
-## English
-
-A MCP server for stock and crypto market analysis. Supports US stocks, cryptocurrency, A-shares, and Hong Kong stocks.
-
-### Features
-
-- **US Stocks** — real-time quotes, K-line data, company profile, major indices (S&P 500, NASDAQ, Dow Jones, Russell 2000, VIX)
-- **Cryptocurrency** — market overview, fear & greed index, top coins by market cap, sector categories, perpetual funding rates
-- **A-shares & HK Stocks** — real-time quotes via Tencent Finance
-- **Stock Search** — search any symbol by name or ticker
-
-### Tools
-
-| Tool | Description |
-|------|-------------|
-| `get_quote` | Real-time price quote for US stocks, crypto, A-shares, HK stocks |
-| `get_kline` | K-line (OHLCV) data — daily / weekly / monthly |
-| `search_stock` | Search stocks and crypto by keyword |
-| `get_us_indices` | Major US market indices |
-| `get_stock_profile` | Company profile and fundamentals |
-| `get_crypto_overview` | Global crypto market cap + fear & greed index |
-| `get_crypto_top` | Top N coins by market cap |
-| `get_crypto_categories` | Crypto sector categories (DeFi, Layer1, AI, GameFi…) |
-| `get_funding_rate` | Binance perpetual contract funding rates |
-
-### Installation
-
-```bash
-npx stock-mcp
-```
-
-Or install globally:
-
-```bash
-npm install -g stock-mcp
-```
-
-### Claude Desktop Configuration
-
-Add to your `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "stock-mcp": {
-      "command": "npx",
-      "args": ["-y", "stock-mcp"]
-    }
-  }
-}
-```
-
-### Development
-
-```bash
-git clone https://github.com/gxz2019/stock-mcp.git
-cd stock-mcp
-npm install
-npm run build
-```
-
----
-
-## 中文
-
-股票与加密货币市场分析的 MCP 服务器，支持美股、加密货币、A股和港股。
-
-### 功能特性
+## 功能
 
 - **美股** — 实时行情、K线数据、公司简介、主要指数（标普500、纳斯达克、道琼斯、罗素2000、VIX）
 - **加密货币** — 市场概况、恐惧贪婪指数、市值排名、赛道分类、永续合约资金费率
-- **A股 & 港股** — 通过腾讯财经获取实时行情
+- **A股 & 港股** — 腾讯财经实时行情
 - **股票搜索** — 按名称或代码搜索任意标的
 
-### 工具列表
+## 工具列表
 
 | 工具 | 说明 |
 |------|------|
-| `get_quote` | 美股、加密货币、A股、港股实时报价 |
-| `get_kline` | K线数据（OHLCV），支持日线/周线/月线 |
+| `get_quote` | 实时报价（美股 / 加密货币 / A股 / 港股） |
+| `get_kline` | K线数据，支持日线 / 周线 / 月线 |
 | `search_stock` | 按关键词搜索股票和加密货币 |
 | `get_us_indices` | 美国主要市场指数 |
-| `get_stock_profile` | 公司基本面和简介 |
+| `get_stock_profile` | 公司基本面信息 |
 | `get_crypto_overview` | 全球加密市场总市值 + 恐惧贪婪指数 |
 | `get_crypto_top` | 按市值排名的 Top N 币种 |
 | `get_crypto_categories` | 加密货币赛道分类（DeFi、Layer1、AI、GameFi…） |
 | `get_funding_rate` | Binance 永续合约资金费率 |
 
-### 安装
+## 使用方法
 
-```bash
-npx stock-mcp
-```
+### Claude Desktop
 
-或全局安装：
+编辑配置文件：
+- macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows：`%APPDATA%\Claude\claude_desktop_config.json`
 
-```bash
-npm install -g stock-mcp
-```
-
-### Claude Desktop 配置
-
-在 `claude_desktop_config.json` 中添加：
+添加以下内容：
 
 ```json
 {
   "mcpServers": {
-    "stock-mcp": {
+    "xstock-mcp": {
       "command": "npx",
-      "args": ["-y", "stock-mcp"]
+      "args": ["-y", "xstock-mcp"]
     }
   }
 }
 ```
 
-### 本地开发
+保存后重启 Claude Desktop 即可使用。
+
+### 其他支持 MCP 的客户端（Cursor、OpenClaw 等）
+
+配置方式相同，将上面的 JSON 添加到对应客户端的 MCP 配置文件中。
+
+## 本地开发
 
 ```bash
 git clone https://github.com/gxz2019/stock-mcp.git

package/dist/index.js

@@ -225,6 +225,35 @@ async function fetchUSKlines(symbol, startDate, endDate, interval = "1d") {
 `);
   return bars;
 }
+async function fetchEarningsCalendar(symbol) {
+  process.stderr.write(`[yahoo] fetchEarningsCalendar symbol=${symbol}
+`);
+  const summary = await yf.quoteSummary(symbol, {
+    modules: ["calendarEvents", "earningsHistory"]
+  });
+  const cal = summary.calendarEvents;
+  const history = summary.earningsHistory;
+  const earningsDates = cal?.earnings;
+  const dateArr = earningsDates?.earningsDate;
+  const nextDate = dateArr && dateArr.length > 0 ? dateArr[0] : null;
+  const endDate = dateArr && dateArr.length > 1 ? dateArr[dateArr.length - 1] : null;
+  const histArr = history?.history ?? [];
+  const recentEPS = histArr.slice(-4).map((h) => {
+    const date = h.quarter instanceof Date ? h.quarter.toISOString().slice(0, 10) : String(h.quarter ?? "");
+    const actual = typeof h.epsActual === "number" ? h.epsActual : null;
+    const estimate = typeof h.epsEstimate === "number" ? h.epsEstimate : null;
+    const surprise = actual !== null && estimate !== null && estimate !== 0 ? Math.round((actual - estimate) / Math.abs(estimate) * 1e4) / 100 : null;
+    return { date, actual, estimate, surprise };
+  });
+  return {
+    symbol,
+    nextEarningsDate: nextDate ? nextDate.toISOString().slice(0, 10) : null,
+    earningsDatesRange: nextDate && endDate ? `${nextDate.toISOString().slice(0, 10)} ~ ${endDate.toISOString().slice(0, 10)}` : null,
+    exDividendDate: cal?.exDividendDate instanceof Date ? cal.exDividendDate.toISOString().slice(0, 10) : null,
+    dividendDate: cal?.dividendDate instanceof Date ? cal.dividendDate.toISOString().slice(0, 10) : null,
+    recentEPS
+  };
+}
 async function fetchStockProfile(symbol) {
   process.stderr.write(`[yahoo] fetchStockProfile symbol=${symbol}
 `);
@@ -295,6 +324,38 @@ async function fetchCryptoTickers(symbols) {
   );
   return results.filter(Boolean);
 }
+async function fetchMarketSentiment(symbol, period = "1h") {
+  const sym = normalizeSymbol(symbol);
+  process.stderr.write(`[binance] fetchMarketSentiment symbol=${sym} period=${period}
+`);
+  const base = "https://fapi.binance.com";
+  const params = `symbol=${sym}&period=${period}&limit=1`;
+  const [oiRes, globalRes, topAccRes, topPosRes, takerRes] = await Promise.all([
+    import_axios2.default.get(`${base}/fapi/v1/openInterest?symbol=${sym}`, { timeout: 5e3 }),
+    import_axios2.default.get(`${base}/futures/data/globalLongShortAccountRatio?${params}`, { timeout: 5e3 }),
+    import_axios2.default.get(`${base}/futures/data/topLongShortAccountRatio?${params}`, { timeout: 5e3 }),
+    import_axios2.default.get(`${base}/futures/data/topLongShortPositionRatio?${params}`, { timeout: 5e3 }),
+    import_axios2.default.get(`${base}/futures/data/takerlongshortRatio?${params}`, { timeout: 5e3 })
+  ]);
+  const oi = oiRes.data;
+  const global = globalRes.data[0] ?? {};
+  const topAcc = topAccRes.data[0] ?? {};
+  const topPos = topPosRes.data[0] ?? {};
+  const taker = takerRes.data[0] ?? {};
+  return {
+    symbol: sym,
+    openInterest: parseFloat(oi.openInterest),
+    openInterestUnit: sym.replace("USDT", ""),
+    globalLongRatio: parseFloat(global.longAccount ?? "0"),
+    globalShortRatio: parseFloat(global.shortAccount ?? "0"),
+    topAccountLongRatio: parseFloat(topAcc.longAccount ?? "0"),
+    topAccountShortRatio: parseFloat(topAcc.shortAccount ?? "0"),
+    topPositionLongRatio: parseFloat(topPos.longPosition ?? "0"),
+    topPositionShortRatio: parseFloat(topPos.shortPosition ?? "0"),
+    takerBuyRatio: parseFloat(taker.buySellRatio ?? "0"),
+    takerSellRatio: taker.buySellRatio ? 1 / parseFloat(taker.buySellRatio) : 0
+  };
+}
 async function fetchCryptoKlines(symbol, interval = "1d", limit = 100) {
   const sym = normalizeSymbol(symbol);
   process.stderr.write(`[binance] fetchCryptoKlines symbol=${sym} interval=${interval} limit=${limit}
@@ -374,6 +435,138 @@ var getQuoteTool = {
 
 // src/tools/kline.ts
 var import_zod2 = require("zod");
+
+// src/utils/indicators.ts
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function calcMA(closes, period) {
+  return closes.map((_, i) => {
+    if (i < period - 1) return null;
+    const sum = closes.slice(i - period + 1, i + 1).reduce((a, b) => a + b, 0);
+    return round2(sum / period);
+  });
+}
+function calcEMA(closes, period) {
+  const result = new Array(closes.length).fill(null);
+  const k = 2 / (period + 1);
+  let prev = null;
+  for (let i = 0; i < closes.length; i++) {
+    if (prev === null) {
+      if (i < period - 1) continue;
+      const sum = closes.slice(0, period).reduce((a, b) => a + b, 0);
+      prev = sum / period;
+      result[i] = round2(prev);
+    } else {
+      prev = closes[i] * k + prev * (1 - k);
+      result[i] = round2(prev);
+    }
+  }
+  return result;
+}
+function calcRSI(closes, period = 14) {
+  const result = new Array(closes.length).fill(null);
+  if (closes.length < period + 1) return result;
+  let avgGain = 0;
+  let avgLoss = 0;
+  for (let i = 1; i <= period; i++) {
+    const diff = closes[i] - closes[i - 1];
+    if (diff > 0) avgGain += diff;
+    else avgLoss += Math.abs(diff);
+  }
+  avgGain /= period;
+  avgLoss /= period;
+  const rs = avgLoss === 0 ? 100 : avgGain / avgLoss;
+  result[period] = round2(100 - 100 / (1 + rs));
+  for (let i = period + 1; i < closes.length; i++) {
+    const diff = closes[i] - closes[i - 1];
+    const gain = diff > 0 ? diff : 0;
+    const loss = diff < 0 ? Math.abs(diff) : 0;
+    avgGain = (avgGain * (period - 1) + gain) / period;
+    avgLoss = (avgLoss * (period - 1) + loss) / period;
+    const r = avgLoss === 0 ? 100 : avgGain / avgLoss;
+    result[i] = round2(100 - 100 / (1 + r));
+  }
+  return result;
+}
+function calcMACD(closes, fast = 12, slow = 26, signal = 9) {
+  const emaFast = calcEMA(closes, fast);
+  const emaSlow = calcEMA(closes, slow);
+  const macdLine = closes.map((_, i) => {
+    if (emaFast[i] === null || emaSlow[i] === null) return null;
+    return round2(emaFast[i] - emaSlow[i]);
+  });
+  const signalLine = new Array(closes.length).fill(null);
+  const histogram = new Array(closes.length).fill(null);
+  const k = 2 / (signal + 1);
+  let prev = null;
+  let count = 0;
+  for (let i = 0; i < macdLine.length; i++) {
+    if (macdLine[i] === null) continue;
+    count++;
+    if (prev === null) {
+      if (count < signal) continue;
+      let sum = 0;
+      let cnt = 0;
+      for (let j = i; j >= 0 && cnt < signal; j--) {
+        if (macdLine[j] !== null) {
+          sum += macdLine[j];
+          cnt++;
+        }
+      }
+      prev = sum / signal;
+      signalLine[i] = round2(prev);
+    } else {
+      prev = macdLine[i] * k + prev * (1 - k);
+      signalLine[i] = round2(prev);
+    }
+    if (signalLine[i] !== null) {
+      histogram[i] = round2(macdLine[i] - signalLine[i]);
+    }
+  }
+  return { macd: macdLine, signal: signalLine, histogram };
+}
+function calcBOLL(closes, period = 20, multiplier = 2) {
+  const upper = new Array(closes.length).fill(null);
+  const middle = new Array(closes.length).fill(null);
+  const lower = new Array(closes.length).fill(null);
+  for (let i = period - 1; i < closes.length; i++) {
+    const slice = closes.slice(i - period + 1, i + 1);
+    const mean = slice.reduce((a, b) => a + b, 0) / period;
+    const variance = slice.reduce((a, b) => a + Math.pow(b - mean, 2), 0) / period;
+    const std = Math.sqrt(variance);
+    middle[i] = round2(mean);
+    upper[i] = round2(mean + multiplier * std);
+    lower[i] = round2(mean - multiplier * std);
+  }
+  return { upper, middle, lower };
+}
+function attachIndicators(bars) {
+  const closes = bars.map((b) => b.close);
+  const ma5 = calcMA(closes, 5);
+  const ma10 = calcMA(closes, 10);
+  const ma20 = calcMA(closes, 20);
+  const ma60 = calcMA(closes, 60);
+  const rsi14 = calcRSI(closes, 14);
+  const macdResult = calcMACD(closes);
+  const bollResult = calcBOLL(closes);
+  return bars.map((b, i) => ({
+    ...b,
+    ma5: ma5[i],
+    ma10: ma10[i],
+    ma20: ma20[i],
+    ma60: ma60[i],
+    rsi14: rsi14[i],
+    macd: macdResult.macd[i],
+    macdSignal: macdResult.signal[i],
+    macdHist: macdResult.histogram[i],
+    bollUpper: bollResult.upper[i],
+    bollMiddle: bollResult.middle[i],
+    bollLower: bollResult.lower[i]
+  }));
+}
+
+// src/tools/kline.ts
 var periodToYahoo = {
   daily: "1d",
   weekly: "1wk",
@@ -452,6 +645,85 @@ var getKlineTool = {
     }
   }
 };
+var IndicatorInput = import_zod2.z.object({
+  market: import_zod2.z.enum(["us", "crypto"]),
+  code: import_zod2.z.string(),
+  period: import_zod2.z.enum(["daily", "weekly", "monthly"]).optional(),
+  start: import_zod2.z.string().optional(),
+  end: import_zod2.z.string().optional(),
+  interval: import_zod2.z.string().optional(),
+  limit: import_zod2.z.number().int().min(1).max(500).optional()
+});
+var getKlineWithIndicatorsTool = {
+  tool: {
+    name: "get_kline_with_indicators",
+    description: "\u83B7\u53D6K\u7EBF\u6570\u636E\u5E76\u9644\u5E26\u8BA1\u7B97\u597D\u7684\u6280\u672F\u6307\u6807\uFF08MA5/10/20/60\u3001RSI14\u3001MACD\u3001\u5E03\u6797\u5E26\uFF09\u3002\u652F\u6301\u7F8E\u80A1\uFF08market=us\uFF09\u548C\u52A0\u5BC6\u8D27\u5E01\uFF08market=crypto\uFF09\u3002\u8FD4\u56DE\u6700\u8FD1\u6570\u636E\uFF0C\u6307\u6807\u5747\u4E3A\u7CBE\u786E\u8BA1\u7B97\u503C\uFF0C\u53EF\u76F4\u63A5\u7528\u4E8E\u5206\u6790\u3002",
+    inputSchema: {
+      type: "object",
+      properties: {
+        market: {
+          type: "string",
+          enum: ["us", "crypto"],
+          description: "\u5E02\u573A\u7C7B\u578B\uFF1Aus=\u7F8E\u80A1\uFF0Ccrypto=\u52A0\u5BC6\u8D27\u5E01"
+        },
+        code: {
+          type: "string",
+          description: "\u4EE3\u7801\uFF0C\u5982 AAPL\u3001NVDA\u3001BTC\u3001ETH"
+        },
+        period: {
+          type: "string",
+          enum: ["daily", "weekly", "monthly"],
+          description: "\u7F8E\u80A1\u5468\u671F\uFF0C\u9ED8\u8BA4 daily"
+        },
+        start: {
+          type: "string",
+          description: "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD\uFF08\u4EC5\u7F8E\u80A1\uFF0C\u9ED8\u8BA4\u8FD1180\u5929\uFF09"
+        },
+        end: {
+          type: "string",
+          description: "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD\uFF08\u4EC5\u7F8E\u80A1\uFF0C\u9ED8\u8BA4\u4ECA\u5929\uFF09"
+        },
+        interval: {
+          type: "string",
+          description: "\u52A0\u5BC6\u8D27\u5E01\u5468\u671F\uFF0C\u5982 1d\u30014h\u30011h\uFF0C\u9ED8\u8BA4 1d"
+        },
+        limit: {
+          type: "number",
+          description: "\u52A0\u5BC6\u8D27\u5E01\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4200\uFF08\u6307\u6807\u9700\u8981\u8DB3\u591F\u5386\u53F2\u6570\u636E\uFF09"
+        }
+      },
+      required: ["market", "code"]
+    }
+  },
+  handler: async (input) => {
+    const parsed = IndicatorInput.safeParse(input);
+    if (!parsed.success) return err(parsed.error.message);
+    const { market, code, period, start, end, interval, limit } = parsed.data;
+    try {
+      let bars;
+      if (market === "us") {
+        const endDate = end ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+        const startDate = start ?? new Date(Date.now() - 180 * 864e5).toISOString().slice(0, 10);
+        const yInterval = periodToYahoo[period ?? "daily"] ?? "1d";
+        bars = await fetchUSKlines(code, startDate, endDate, yInterval);
+      } else {
+        bars = await fetchCryptoKlines(code, interval ?? "1d", limit ?? 200);
+      }
+      if (bars.length < 2) return err("\u6570\u636E\u4E0D\u8DB3\uFF0C\u65E0\u6CD5\u8BA1\u7B97\u6307\u6807");
+      const withIndicators = attachIndicators(bars);
+      const recent = withIndicators.slice(-60);
+      return ok({
+        symbol: code.toUpperCase(),
+        market,
+        total: bars.length,
+        returned: recent.length,
+        bars: recent
+      });
+    } catch (e) {
+      return err(e.message);
+    }
+  }
+};
 
 // src/tools/search.ts
 var import_zod3 = require("zod");
@@ -535,6 +807,75 @@ var getUsIndicesTool = {
     }
   }
 };
+var SECTOR_ETFS = {
+  XLK: "\u79D1\u6280",
+  XLF: "\u91D1\u878D",
+  XLV: "\u533B\u7597\u5065\u5EB7",
+  XLE: "\u80FD\u6E90",
+  XLI: "\u5DE5\u4E1A",
+  XLY: "\u975E\u5FC5\u9700\u6D88\u8D39",
+  XLP: "\u5FC5\u9700\u6D88\u8D39",
+  XLB: "\u6750\u6599",
+  XLU: "\u516C\u7528\u4E8B\u4E1A",
+  XLRE: "\u623F\u5730\u4EA7",
+  XLC: "\u901A\u4FE1\u670D\u52A1"
+};
+var getUsSectorHeatmapTool = {
+  tool: {
+    name: "get_us_sector_heatmap",
+    description: "\u83B7\u53D6\u7F8E\u80A111\u5927\u884C\u4E1A\u677F\u5757\u4ECA\u65E5\u6DA8\u8DCC\u5E45\uFF0C\u57FA\u4E8E SPDR \u884C\u4E1A ETF\uFF08XLK/XLF/XLE \u7B49\uFF09\uFF0C\u7528\u4E8E\u5224\u65AD\u8D44\u91D1\u6D41\u5411\u548C\u677F\u5757\u8F6E\u52A8\u3002",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  handler: async () => {
+    try {
+      const symbols = Object.keys(SECTOR_ETFS);
+      const quotes = await fetchUSQuotes(symbols);
+      const result = quotes.map((q) => ({
+        etf: q.symbol,
+        sector: SECTOR_ETFS[q.symbol] ?? q.symbol,
+        price: q.price,
+        change: q.change,
+        changePercent: q.changePercent,
+        volume: q.volume
+      })).sort((a, b) => parseFloat(b.changePercent) - parseFloat(a.changePercent));
+      return ok(result);
+    } catch (e) {
+      return err(e.message);
+    }
+  }
+};
+var SymbolInput = import_zod4.z.object({
+  symbol: import_zod4.z.string().min(1)
+});
+var getEarningsCalendarTool = {
+  tool: {
+    name: "get_earnings_calendar",
+    description: "\u67E5\u8BE2\u7F8E\u80A1\u4E0A\u5E02\u516C\u53F8\u7684\u4E0B\u6B21\u8D22\u62A5\u65E5\u671F\u3001EPS\u9884\u671F\uFF0C\u4EE5\u53CA\u8FD14\u5B63\u5EA6\u7684\u5B9E\u9645EPS\u3001\u9884\u671FEPS\u548C\u8D85\u9884\u671F\u5E45\u5EA6\uFF08surprise%\uFF09\u3002",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbol: {
+          type: "string",
+          description: "\u7F8E\u80A1\u4EE3\u7801\uFF0C\u5982 AAPL\u3001NVDA\u3001TSLA"
+        }
+      },
+      required: ["symbol"]
+    }
+  },
+  handler: async (input) => {
+    const parsed = SymbolInput.safeParse(input);
+    if (!parsed.success) return err(parsed.error.message);
+    try {
+      return ok(await fetchEarningsCalendar(parsed.data.symbol));
+    } catch (e) {
+      return err(e.message);
+    }
+  }
+};
 var ProfileInput = import_zod4.z.object({
   symbol: import_zod4.z.string().min(1)
 });
@@ -772,18 +1113,69 @@ var getCryptoFundingTool = {
     }
   }
 };
+var LiquidationInput = import_zod5.z.object({
+  symbols: import_zod5.z.array(import_zod5.z.string()).min(1).max(10),
+  period: import_zod5.z.enum(["5m", "15m", "30m", "1h", "4h", "1d"]).optional()
+});
+var getCryptoLiquidationTool = {
+  tool: {
+    name: "get_crypto_liquidation",
+    description: "\u83B7\u53D6\u52A0\u5BC6\u8D27\u5E01\u5408\u7EA6\u5E02\u573A\u60C5\u7EEA\u6570\u636E\uFF1A\u672A\u5E73\u4ED3\u5408\u7EA6\uFF08OI\uFF09\u3001\u5168\u7403\u591A\u7A7A\u8D26\u6237\u6BD4\u3001\u4E3B\u529B\u591A\u7A7A\u6301\u4ED3\u6BD4\u3001\u5403\u5355\u4E70\u5356\u6BD4\u3002\u53EF\u7528\u4E8E\u5224\u65AD\u6760\u6746\u805A\u96C6\u7A0B\u5EA6\u548C\u6E05\u7B97\u98CE\u9669\u3002symbols \u4F20\u5E01\u79CD\u4EE3\u7801\u5982 ['BTC','ETH']\u3002",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbols: {
+          type: "array",
+          items: { type: "string" },
+          description: "\u5E01\u79CD\u4EE3\u7801\u5217\u8868\uFF0C\u5982 ['BTC','ETH']",
+          minItems: 1,
+          maxItems: 10
+        },
+        period: {
+          type: "string",
+          enum: ["5m", "15m", "30m", "1h", "4h", "1d"],
+          description: "\u7EDF\u8BA1\u5468\u671F\uFF0C\u9ED8\u8BA4 1h"
+        }
+      },
+      required: ["symbols"]
+    }
+  },
+  handler: async (input) => {
+    const parsed = LiquidationInput.safeParse(input);
+    if (!parsed.success) return err(parsed.error.message);
+    const { symbols, period = "1h" } = parsed.data;
+    try {
+      const results = await Promise.all(
+        symbols.map(async (sym) => {
+          try {
+            return await fetchMarketSentiment(sym, period);
+          } catch {
+            return { symbol: sym.toUpperCase() + "USDT", error: "not available or not a perpetual contract" };
+          }
+        })
+      );
+      return ok(results);
+    } catch (e) {
+      return err(e.message);
+    }
+  }
+};
 
 // src/tools/index.ts
 var tools = [
   getQuoteTool,
   getKlineTool,
+  getKlineWithIndicatorsTool,
   searchStockTool,
   getUsIndicesTool,
   getStockProfileTool,
+  getEarningsCalendarTool,
+  getUsSectorHeatmapTool,
   getCryptoOverviewTool,
   getCryptoTopTool,
   getCryptoCatsTool,
-  getCryptoFundingTool
+  getCryptoFundingTool,
+  getCryptoLiquidationTool
 ];
 var toolMap = new Map(
   tools.map((t) => [t.tool.name, t])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xstock-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Stock & Crypto analysis MCP Server",
   "main": "dist/index.js",
   "bin": {

package/src/data/binance.ts

@@ -63,6 +63,56 @@ export async function fetchCryptoTickers(symbols: string[]): Promise<CryptoTicke
   return results.filter(Boolean) as CryptoTicker[];
 }
 
+export interface MarketSentiment {
+  symbol: string;
+  openInterest: number;
+  openInterestUnit: string;
+  globalLongRatio: number;
+  globalShortRatio: number;
+  topAccountLongRatio: number;
+  topAccountShortRatio: number;
+  topPositionLongRatio: number;
+  topPositionShortRatio: number;
+  takerBuyRatio: number;
+  takerSellRatio: number;
+}
+
+export async function fetchMarketSentiment(symbol: string, period = "1h"): Promise<MarketSentiment> {
+  const sym = normalizeSymbol(symbol);
+  process.stderr.write(`[binance] fetchMarketSentiment symbol=${sym} period=${period}\n`);
+
+  const base = "https://fapi.binance.com";
+  const params = `symbol=${sym}&period=${period}&limit=1`;
+
+  const [oiRes, globalRes, topAccRes, topPosRes, takerRes] = await Promise.all([
+    axios.get(`${base}/fapi/v1/openInterest?symbol=${sym}`, { timeout: 5000 }),
+    axios.get(`${base}/futures/data/globalLongShortAccountRatio?${params}`, { timeout: 5000 }),
+    axios.get(`${base}/futures/data/topLongShortAccountRatio?${params}`, { timeout: 5000 }),
+    axios.get(`${base}/futures/data/topLongShortPositionRatio?${params}`, { timeout: 5000 }),
+    axios.get(`${base}/futures/data/takerlongshortRatio?${params}`, { timeout: 5000 }),
+  ]);
+
+  const oi = oiRes.data;
+  const global = globalRes.data[0] ?? {};
+  const topAcc = topAccRes.data[0] ?? {};
+  const topPos = topPosRes.data[0] ?? {};
+  const taker = takerRes.data[0] ?? {};
+
+  return {
+    symbol: sym,
+    openInterest: parseFloat(oi.openInterest),
+    openInterestUnit: sym.replace("USDT", ""),
+    globalLongRatio: parseFloat(global.longAccount ?? "0"),
+    globalShortRatio: parseFloat(global.shortAccount ?? "0"),
+    topAccountLongRatio: parseFloat(topAcc.longAccount ?? "0"),
+    topAccountShortRatio: parseFloat(topAcc.shortAccount ?? "0"),
+    topPositionLongRatio: parseFloat(topPos.longPosition ?? "0"),
+    topPositionShortRatio: parseFloat(topPos.shortPosition ?? "0"),
+    takerBuyRatio: parseFloat(taker.buySellRatio ?? "0"),
+    takerSellRatio: taker.buySellRatio ? (1 / parseFloat(taker.buySellRatio)) : 0,
+  };
+}
+
 export async function fetchCryptoKlines(
   symbol: string,
   interval: string = "1d",

package/src/data/yahoo.ts

@@ -108,6 +108,56 @@ export async function fetchUSKlines(
   return bars;
 }
 
+export interface EarningsCalendar {
+  symbol: string;
+  nextEarningsDate: string | null;
+  earningsDatesRange: string | null;
+  exDividendDate: string | null;
+  dividendDate: string | null;
+  recentEPS: { date: string; actual: number | null; estimate: number | null; surprise: number | null }[];
+}
+
+export async function fetchEarningsCalendar(symbol: string): Promise<EarningsCalendar> {
+  process.stderr.write(`[yahoo] fetchEarningsCalendar symbol=${symbol}\n`);
+  const summary = await yf.quoteSummary(symbol, {
+    modules: ["calendarEvents", "earningsHistory"],
+  });
+
+  const cal = summary.calendarEvents as Record<string, unknown> | undefined;
+  const history = summary.earningsHistory as Record<string, unknown> | undefined;
+
+  // 财报日期
+  const earningsDates = cal?.earnings as Record<string, unknown> | undefined;
+  const dateArr = earningsDates?.earningsDate as Date[] | undefined;
+  const nextDate = dateArr && dateArr.length > 0 ? dateArr[0] : null;
+  const endDate = dateArr && dateArr.length > 1 ? dateArr[dateArr.length - 1] : null;
+
+  // 近期 EPS 历史
+  const histArr = (history?.history as Record<string, unknown>[] | undefined) ?? [];
+  const recentEPS = histArr.slice(-4).map((h) => {
+    const date = h.quarter instanceof Date ? h.quarter.toISOString().slice(0, 10) : String(h.quarter ?? "");
+    const actual = typeof h.epsActual === "number" ? h.epsActual : null;
+    const estimate = typeof h.epsEstimate === "number" ? h.epsEstimate : null;
+    const surprise = actual !== null && estimate !== null && estimate !== 0
+      ? Math.round(((actual - estimate) / Math.abs(estimate)) * 10000) / 100
+      : null;
+    return { date, actual, estimate, surprise };
+  });
+
+  return {
+    symbol,
+    nextEarningsDate: nextDate ? (nextDate as Date).toISOString().slice(0, 10) : null,
+    earningsDatesRange: nextDate && endDate
+      ? `${(nextDate as Date).toISOString().slice(0, 10)} ~ ${(endDate as Date).toISOString().slice(0, 10)}`
+      : null,
+    exDividendDate: cal?.exDividendDate instanceof Date
+      ? cal.exDividendDate.toISOString().slice(0, 10) : null,
+    dividendDate: cal?.dividendDate instanceof Date
+      ? cal.dividendDate.toISOString().slice(0, 10) : null,
+    recentEPS,
+  };
+}
+
 export async function fetchStockProfile(symbol: string): Promise<StockProfile> {
   process.stderr.write(`[yahoo] fetchStockProfile symbol=${symbol}\n`);
   const summary = await yf.quoteSummary(symbol, {

package/src/tools/crypto.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import axios from "axios";
 import { fetchGlobalMarket, fetchTopCoins, fetchFearGreed, fetchCategories } from "../data/coingecko";
+import { fetchMarketSentiment } from "../data/binance";
 import type { ToolDef } from "./types";
 import { ok, err } from "./types";
 
@@ -143,3 +144,55 @@ export const getCryptoFundingTool: ToolDef = {
     }
   },
 };
+
+const LiquidationInput = z.object({
+  symbols: z.array(z.string()).min(1).max(10),
+  period: z.enum(["5m", "15m", "30m", "1h", "4h", "1d"]).optional(),
+});
+
+export const getCryptoLiquidationTool: ToolDef = {
+  tool: {
+    name: "get_crypto_liquidation",
+    description:
+      "获取加密货币合约市场情绪数据：未平仓合约（OI）、全球多空账户比、主力多空持仓比、吃单买卖比。" +
+      "可用于判断杠杆聚集程度和清算风险。symbols 传币种代码如 ['BTC','ETH']。",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbols: {
+          type: "array",
+          items: { type: "string" },
+          description: "币种代码列表，如 ['BTC','ETH']",
+          minItems: 1,
+          maxItems: 10,
+        },
+        period: {
+          type: "string",
+          enum: ["5m", "15m", "30m", "1h", "4h", "1d"],
+          description: "统计周期，默认 1h",
+        },
+      },
+      required: ["symbols"],
+    },
+  },
+  handler: async (input) => {
+    const parsed = LiquidationInput.safeParse(input);
+    if (!parsed.success) return err(parsed.error.message);
+    const { symbols, period = "1h" } = parsed.data;
+
+    try {
+      const results = await Promise.all(
+        symbols.map(async (sym) => {
+          try {
+            return await fetchMarketSentiment(sym, period);
+          } catch {
+            return { symbol: sym.toUpperCase() + "USDT", error: "not available or not a perpetual contract" };
+          }
+        })
+      );
+      return ok(results);
+    } catch (e) {
+      return err((e as Error).message);
+    }
+  },
+};

package/src/tools/index.ts

@@ -1,22 +1,26 @@
 import type { ToolDef } from "./types";
 import { getQuoteTool } from "./quotes";
-import { getKlineTool } from "./kline";
+import { getKlineTool, getKlineWithIndicatorsTool } from "./kline";
 import { searchStockTool } from "./search";
-import { getUsIndicesTool, getStockProfileTool } from "./us-market";
-import { getCryptoOverviewTool, getCryptoTopTool, getCryptoCatsTool, getCryptoFundingTool } from "./crypto";
+import { getUsIndicesTool, getStockProfileTool, getEarningsCalendarTool, getUsSectorHeatmapTool } from "./us-market";
+import { getCryptoOverviewTool, getCryptoTopTool, getCryptoCatsTool, getCryptoFundingTool, getCryptoLiquidationTool } from "./crypto";
 
 export * from "./types";
 
 export const tools: ToolDef[] = [
   getQuoteTool,
   getKlineTool,
+  getKlineWithIndicatorsTool,
   searchStockTool,
   getUsIndicesTool,
   getStockProfileTool,
+  getEarningsCalendarTool,
+  getUsSectorHeatmapTool,
   getCryptoOverviewTool,
   getCryptoTopTool,
   getCryptoCatsTool,
   getCryptoFundingTool,
+  getCryptoLiquidationTool,
 ];
 
 export const toolMap = new Map<string, ToolDef>(

package/src/tools/kline.ts

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { fetchAShareKline, fetchHKKline } from "../data/tencent";
 import { fetchUSKlines } from "../data/yahoo";
 import { fetchCryptoKlines } from "../data/binance";
+import { attachIndicators } from "../utils/indicators";
 import type { ToolDef } from "./types";
 import { ok, err } from "./types";
 
@@ -89,3 +90,93 @@ export const getKlineTool: ToolDef = {
     }
   },
 };
+
+const IndicatorInput = z.object({
+  market: z.enum(["us", "crypto"]),
+  code: z.string(),
+  period: z.enum(["daily", "weekly", "monthly"]).optional(),
+  start: z.string().optional(),
+  end: z.string().optional(),
+  interval: z.string().optional(),
+  limit: z.number().int().min(1).max(500).optional(),
+});
+
+export const getKlineWithIndicatorsTool: ToolDef = {
+  tool: {
+    name: "get_kline_with_indicators",
+    description:
+      "获取K线数据并附带计算好的技术指标（MA5/10/20/60、RSI14、MACD、布林带）。" +
+      "支持美股（market=us）和加密货币（market=crypto）。" +
+      "返回最近数据，指标均为精确计算值，可直接用于分析。",
+    inputSchema: {
+      type: "object",
+      properties: {
+        market: {
+          type: "string",
+          enum: ["us", "crypto"],
+          description: "市场类型：us=美股，crypto=加密货币",
+        },
+        code: {
+          type: "string",
+          description: "代码，如 AAPL、NVDA、BTC、ETH",
+        },
+        period: {
+          type: "string",
+          enum: ["daily", "weekly", "monthly"],
+          description: "美股周期，默认 daily",
+        },
+        start: {
+          type: "string",
+          description: "开始日期 YYYY-MM-DD（仅美股，默认近180天）",
+        },
+        end: {
+          type: "string",
+          description: "结束日期 YYYY-MM-DD（仅美股，默认今天）",
+        },
+        interval: {
+          type: "string",
+          description: "加密货币周期，如 1d、4h、1h，默认 1d",
+        },
+        limit: {
+          type: "number",
+          description: "加密货币返回条数，默认200（指标需要足够历史数据）",
+        },
+      },
+      required: ["market", "code"],
+    },
+  },
+  handler: async (input) => {
+    const parsed = IndicatorInput.safeParse(input);
+    if (!parsed.success) return err(parsed.error.message);
+    const { market, code, period, start, end, interval, limit } = parsed.data;
+
+    try {
+      let bars: { date: string; open: number; high: number; low: number; close: number; volume: number }[];
+
+      if (market === "us") {
+        const endDate = end ?? new Date().toISOString().slice(0, 10);
+        const startDate = start ?? new Date(Date.now() - 180 * 86400_000).toISOString().slice(0, 10);
+        const yInterval = periodToYahoo[period ?? "daily"] ?? "1d";
+        bars = await fetchUSKlines(code, startDate, endDate, yInterval);
+      } else {
+        bars = await fetchCryptoKlines(code, interval ?? "1d", limit ?? 200);
+      }
+
+      if (bars.length < 2) return err("数据不足，无法计算指标");
+
+      const withIndicators = attachIndicators(bars);
+      // 只返回最近60条，减少 token，但保留足够上下文
+      const recent = withIndicators.slice(-60);
+
+      return ok({
+        symbol: code.toUpperCase(),
+        market,
+        total: bars.length,
+        returned: recent.length,
+        bars: recent,
+      });
+    } catch (e) {
+      return err((e as Error).message);
+    }
+  },
+};

package/src/tools/us-market.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { fetchUSQuotes, fetchStockProfile } from "../data/yahoo";
+import { fetchUSQuotes, fetchStockProfile, fetchEarningsCalendar } from "../data/yahoo";
 import type { ToolDef } from "./types";
 import { ok, err } from "./types";
 
@@ -38,6 +38,83 @@ export const getUsIndicesTool: ToolDef = {
   },
 };
 
+const SECTOR_ETFS: Record<string, string> = {
+  XLK:  "科技",
+  XLF:  "金融",
+  XLV:  "医疗健康",
+  XLE:  "能源",
+  XLI:  "工业",
+  XLY:  "非必需消费",
+  XLP:  "必需消费",
+  XLB:  "材料",
+  XLU:  "公用事业",
+  XLRE: "房地产",
+  XLC:  "通信服务",
+};
+
+export const getUsSectorHeatmapTool: ToolDef = {
+  tool: {
+    name: "get_us_sector_heatmap",
+    description:
+      "获取美股11大行业板块今日涨跌幅，基于 SPDR 行业 ETF（XLK/XLF/XLE 等），用于判断资金流向和板块轮动。",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  handler: async () => {
+    try {
+      const symbols = Object.keys(SECTOR_ETFS);
+      const quotes = await fetchUSQuotes(symbols);
+      const result = quotes
+        .map((q) => ({
+          etf: q.symbol,
+          sector: SECTOR_ETFS[q.symbol] ?? q.symbol,
+          price: q.price,
+          change: q.change,
+          changePercent: q.changePercent,
+          volume: q.volume,
+        }))
+        .sort((a, b) => parseFloat(b.changePercent) - parseFloat(a.changePercent));
+      return ok(result);
+    } catch (e) {
+      return err((e as Error).message);
+    }
+  },
+};
+
+const SymbolInput = z.object({
+  symbol: z.string().min(1),
+});
+
+export const getEarningsCalendarTool: ToolDef = {
+  tool: {
+    name: "get_earnings_calendar",
+    description:
+      "查询美股上市公司的下次财报日期、EPS预期，以及近4季度的实际EPS、预期EPS和超预期幅度（surprise%）。",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbol: {
+          type: "string",
+          description: "美股代码，如 AAPL、NVDA、TSLA",
+        },
+      },
+      required: ["symbol"],
+    },
+  },
+  handler: async (input) => {
+    const parsed = SymbolInput.safeParse(input);
+    if (!parsed.success) return err(parsed.error.message);
+    try {
+      return ok(await fetchEarningsCalendar(parsed.data.symbol));
+    } catch (e) {
+      return err((e as Error).message);
+    }
+  },
+};
+
 const ProfileInput = z.object({
   symbol: z.string().min(1),
 });

package/src/utils/indicators.ts

@@ -0,0 +1,178 @@
+// 技术指标计算，输入均为收盘价数组（时间顺序，oldest first）
+
+function round2(n: number): number {
+  return Math.round(n * 100) / 100;
+}
+
+export function calcMA(closes: number[], period: number): (number | null)[] {
+  return closes.map((_, i) => {
+    if (i < period - 1) return null;
+    const sum = closes.slice(i - period + 1, i + 1).reduce((a, b) => a + b, 0);
+    return round2(sum / period);
+  });
+}
+
+export function calcEMA(closes: number[], period: number): (number | null)[] {
+  const result: (number | null)[] = new Array(closes.length).fill(null);
+  const k = 2 / (period + 1);
+  let prev: number | null = null;
+  for (let i = 0; i < closes.length; i++) {
+    if (prev === null) {
+      if (i < period - 1) continue;
+      // 第一个 EMA 用 SMA 初始化
+      const sum = closes.slice(0, period).reduce((a, b) => a + b, 0);
+      prev = sum / period;
+      result[i] = round2(prev);
+    } else {
+      prev = closes[i] * k + prev * (1 - k);
+      result[i] = round2(prev);
+    }
+  }
+  return result;
+}
+
+export function calcRSI(closes: number[], period = 14): (number | null)[] {
+  const result: (number | null)[] = new Array(closes.length).fill(null);
+  if (closes.length < period + 1) return result;
+
+  let avgGain = 0;
+  let avgLoss = 0;
+  for (let i = 1; i <= period; i++) {
+    const diff = closes[i] - closes[i - 1];
+    if (diff > 0) avgGain += diff;
+    else avgLoss += Math.abs(diff);
+  }
+  avgGain /= period;
+  avgLoss /= period;
+
+  const rs = avgLoss === 0 ? 100 : avgGain / avgLoss;
+  result[period] = round2(100 - 100 / (1 + rs));
+
+  for (let i = period + 1; i < closes.length; i++) {
+    const diff = closes[i] - closes[i - 1];
+    const gain = diff > 0 ? diff : 0;
+    const loss = diff < 0 ? Math.abs(diff) : 0;
+    avgGain = (avgGain * (period - 1) + gain) / period;
+    avgLoss = (avgLoss * (period - 1) + loss) / period;
+    const r = avgLoss === 0 ? 100 : avgGain / avgLoss;
+    result[i] = round2(100 - 100 / (1 + r));
+  }
+  return result;
+}
+
+export interface MACDResult {
+  macd: (number | null)[];
+  signal: (number | null)[];
+  histogram: (number | null)[];
+}
+
+export function calcMACD(closes: number[], fast = 12, slow = 26, signal = 9): MACDResult {
+  const emaFast = calcEMA(closes, fast);
+  const emaSlow = calcEMA(closes, slow);
+  const macdLine: (number | null)[] = closes.map((_, i) => {
+    if (emaFast[i] === null || emaSlow[i] === null) return null;
+    return round2((emaFast[i] as number) - (emaSlow[i] as number));
+  });
+
+  // signal = EMA9 of macdLine（只对非 null 段计算）
+  const signalLine: (number | null)[] = new Array(closes.length).fill(null);
+  const histogram: (number | null)[] = new Array(closes.length).fill(null);
+
+  const k = 2 / (signal + 1);
+  let prev: number | null = null;
+  let count = 0;
+  for (let i = 0; i < macdLine.length; i++) {
+    if (macdLine[i] === null) continue;
+    count++;
+    if (prev === null) {
+      if (count < signal) continue;
+      // 用前 signal 个 macd 值初始化
+      let sum = 0;
+      let cnt = 0;
+      for (let j = i; j >= 0 && cnt < signal; j--) {
+        if (macdLine[j] !== null) { sum += macdLine[j] as number; cnt++; }
+      }
+      prev = sum / signal;
+      signalLine[i] = round2(prev);
+    } else {
+      prev = (macdLine[i] as number) * k + prev * (1 - k);
+      signalLine[i] = round2(prev);
+    }
+    if (signalLine[i] !== null) {
+      histogram[i] = round2((macdLine[i] as number) - (signalLine[i] as number));
+    }
+  }
+
+  return { macd: macdLine, signal: signalLine, histogram };
+}
+
+export interface BOLLResult {
+  upper: (number | null)[];
+  middle: (number | null)[];
+  lower: (number | null)[];
+}
+
+export function calcBOLL(closes: number[], period = 20, multiplier = 2): BOLLResult {
+  const upper: (number | null)[] = new Array(closes.length).fill(null);
+  const middle: (number | null)[] = new Array(closes.length).fill(null);
+  const lower: (number | null)[] = new Array(closes.length).fill(null);
+
+  for (let i = period - 1; i < closes.length; i++) {
+    const slice = closes.slice(i - period + 1, i + 1);
+    const mean = slice.reduce((a, b) => a + b, 0) / period;
+    const variance = slice.reduce((a, b) => a + Math.pow(b - mean, 2), 0) / period;
+    const std = Math.sqrt(variance);
+    middle[i] = round2(mean);
+    upper[i] = round2(mean + multiplier * std);
+    lower[i] = round2(mean - multiplier * std);
+  }
+  return { upper, middle, lower };
+}
+
+export interface BarWithIndicators {
+  date: string;
+  open: number;
+  high: number;
+  low: number;
+  close: number;
+  volume: number;
+  ma5: number | null;
+  ma10: number | null;
+  ma20: number | null;
+  ma60: number | null;
+  rsi14: number | null;
+  macd: number | null;
+  macdSignal: number | null;
+  macdHist: number | null;
+  bollUpper: number | null;
+  bollMiddle: number | null;
+  bollLower: number | null;
+}
+
+export function attachIndicators(
+  bars: { date: string; open: number; high: number; low: number; close: number; volume: number }[]
+): BarWithIndicators[] {
+  const closes = bars.map((b) => b.close);
+  const ma5 = calcMA(closes, 5);
+  const ma10 = calcMA(closes, 10);
+  const ma20 = calcMA(closes, 20);
+  const ma60 = calcMA(closes, 60);
+  const rsi14 = calcRSI(closes, 14);
+  const macdResult = calcMACD(closes);
+  const bollResult = calcBOLL(closes);
+
+  return bars.map((b, i) => ({
+    ...b,
+    ma5: ma5[i],
+    ma10: ma10[i],
+    ma20: ma20[i],
+    ma60: ma60[i],
+    rsi14: rsi14[i],
+    macd: macdResult.macd[i],
+    macdSignal: macdResult.signal[i],
+    macdHist: macdResult.histogram[i],
+    bollUpper: bollResult.upper[i],
+    bollMiddle: bollResult.middle[i],
+    bollLower: bollResult.lower[i],
+  }));
+}