xstock-mcp 1.0.0

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "xstock-mcp",
+  "version": "1.0.0",
+  "description": "Stock & Crypto analysis MCP Server",
+  "main": "dist/index.js",
+  "bin": {
+    "xstock-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs --no-splitting --outDir dist",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0",
+    "iconv-lite": "^0.7.2",
+    "yahoo-finance2": "^3.15.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.0.0"
+  }
+}

package/src/data/binance.ts

@@ -0,0 +1,87 @@
+import axios from "axios";
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+export interface CryptoTicker {
+  symbol: string;
+  price: number;
+  change: number;
+  changePercent: string;
+  high: number;
+  low: number;
+  volume: number;
+  quoteVolume: number;
+}
+
+export interface CryptoKlineBar {
+  date: string;
+  open: number;
+  high: number;
+  low: number;
+  close: number;
+  volume: number;
+}
+
+// ─── Utils ────────────────────────────────────────────────────────────────────
+
+// 自动补全 USDT 后缀
+export function normalizeSymbol(symbol: string): string {
+  const s = symbol.toUpperCase();
+  return s.endsWith("USDT") ? s : s + "USDT";
+}
+
+// ─── Fetch Functions ──────────────────────────────────────────────────────────
+
+export async function fetchCryptoTickers(symbols: string[]): Promise<CryptoTicker[]> {
+  process.stderr.write(`[binance] fetchCryptoTickers symbols=${symbols.join(",")}\n`);
+  const results = await Promise.all(
+    symbols.map(async (raw) => {
+      const sym = normalizeSymbol(raw);
+      try {
+        const res = await axios.get(
+          `https://api.binance.com/api/v3/ticker/24hr?symbol=${sym}`,
+          { timeout: 5000 }
+        );
+        const d = res.data;
+        process.stderr.write(`[binance] ${sym} price=${d.lastPrice}\n`);
+        return {
+          symbol: sym,
+          price: parseFloat(d.lastPrice),
+          change: parseFloat(d.priceChange),
+          changePercent: parseFloat(d.priceChangePercent).toFixed(2) + "%",
+          high: parseFloat(d.highPrice),
+          low: parseFloat(d.lowPrice),
+          volume: parseFloat(d.volume),
+          quoteVolume: parseFloat(d.quoteVolume),
+        } as CryptoTicker;
+      } catch (e) {
+        process.stderr.write(`[binance] 请求失败 symbol=${sym} err=${e}\n`);
+        return null;
+      }
+    })
+  );
+  return results.filter(Boolean) as CryptoTicker[];
+}
+
+export async function fetchCryptoKlines(
+  symbol: string,
+  interval: string = "1d",
+  limit: number = 100
+): Promise<CryptoKlineBar[]> {
+  const sym = normalizeSymbol(symbol);
+  process.stderr.write(`[binance] fetchCryptoKlines symbol=${sym} interval=${interval} limit=${limit}\n`);
+  const res = await axios.get(
+    `https://api.binance.com/api/v3/klines?symbol=${sym}&interval=${interval}&limit=${limit}`,
+    { timeout: 5000 }
+  );
+  const bars: CryptoKlineBar[] = res.data.map((k: unknown[]) => ({
+    date: new Date(k[0] as number).toISOString().slice(0, 10),
+    open: parseFloat(k[1] as string),
+    high: parseFloat(k[2] as string),
+    low: parseFloat(k[3] as string),
+    close: parseFloat(k[4] as string),
+    volume: parseFloat(k[5] as string),
+  }));
+  process.stderr.write(`[binance] fetchCryptoKlines 返回 ${bars.length} 条\n`);
+  return bars;
+}

package/src/data/coingecko.ts

@@ -0,0 +1,113 @@
+import axios from "axios";
+
+const BASE = "https://api.coingecko.com/api/v3";
+const FEAR_GREED_URL = "https://api.alternative.me/fng/?limit=1";
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+export interface GlobalMarket {
+  totalMarketCapUsd: number;
+  totalVolumeUsd: number;
+  btcDominance: number;
+  ethDominance: number;
+  activeCryptos: number;
+  marketCapChangePercent24h: number;
+}
+
+export interface CoinInfo {
+  rank: number;
+  id: string;
+  symbol: string;
+  name: string;
+  price: number;
+  changePercent24h: number;
+  marketCap: number;
+  volume24h: number;
+}
+
+export interface CategoryInfo {
+  id: string;
+  name: string;
+  marketCap: number;
+  marketCapChange24h: number;
+  volume24h: number;
+  topCoins: string[];
+}
+
+export interface FearGreed {
+  value: number;       // 0-100
+  label: string;       // "Extreme Fear" | "Fear" | "Neutral" | "Greed" | "Extreme Greed"
+  timestamp: string;
+}
+
+// ─── Fetch Functions ──────────────────────────────────────────────────────────
+
+export async function fetchGlobalMarket(): Promise<GlobalMarket> {
+  process.stderr.write(`[coingecko] fetchGlobalMarket\n`);
+  const res = await axios.get(`${BASE}/global`, { timeout: 8000 });
+  const d = res.data.data;
+  const result: GlobalMarket = {
+    totalMarketCapUsd: d.total_market_cap?.usd ?? 0,
+    totalVolumeUsd: d.total_volume?.usd ?? 0,
+    btcDominance: parseFloat(d.market_cap_percentage?.btc?.toFixed(2) ?? "0"),
+    ethDominance: parseFloat(d.market_cap_percentage?.eth?.toFixed(2) ?? "0"),
+    activeCryptos: d.active_cryptocurrencies ?? 0,
+    marketCapChangePercent24h: parseFloat(d.market_cap_change_percentage_24h_usd?.toFixed(2) ?? "0"),
+  };
+  process.stderr.write(`[coingecko] globalMarket btcDominance=${result.btcDominance}%\n`);
+  return result;
+}
+
+export async function fetchTopCoins(limit: number = 50): Promise<CoinInfo[]> {
+  process.stderr.write(`[coingecko] fetchTopCoins limit=${limit}\n`);
+  const res = await axios.get(`${BASE}/coins/markets`, {
+    timeout: 8000,
+    params: {
+      vs_currency: "usd",
+      order: "market_cap_desc",
+      per_page: limit,
+      page: 1,
+      sparkline: false,
+    },
+  });
+  const coins: CoinInfo[] = res.data.map((c: Record<string, unknown>, i: number) => ({
+    rank: i + 1,
+    id: c.id,
+    symbol: (c.symbol as string).toUpperCase(),
+    name: c.name,
+    price: c.current_price,
+    changePercent24h: parseFloat(((c.price_change_percentage_24h as number) ?? 0).toFixed(2)),
+    marketCap: c.market_cap,
+    volume24h: c.total_volume,
+  }));
+  process.stderr.write(`[coingecko] fetchTopCoins 返回 ${coins.length} 条\n`);
+  return coins;
+}
+
+export async function fetchCategories(): Promise<CategoryInfo[]> {
+  process.stderr.write(`[coingecko] fetchCategories\n`);
+  const res = await axios.get(`${BASE}/coins/categories`, { timeout: 8000 });
+  const categories: CategoryInfo[] = res.data.map((c: Record<string, unknown>) => ({
+    id: c.id,
+    name: c.name,
+    marketCap: c.market_cap ?? 0,
+    marketCapChange24h: parseFloat(((c.market_cap_change_24h as number) ?? 0).toFixed(2)),
+    volume24h: c.volume_24h ?? 0,
+    topCoins: (c.top_3_coins as string[] | null) ?? [],
+  }));
+  process.stderr.write(`[coingecko] fetchCategories 返回 ${categories.length} 条\n`);
+  return categories;
+}
+
+export async function fetchFearGreed(): Promise<FearGreed> {
+  process.stderr.write(`[coingecko] fetchFearGreed\n`);
+  const res = await axios.get(FEAR_GREED_URL, { timeout: 5000 });
+  const d = res.data.data[0];
+  const result: FearGreed = {
+    value: parseInt(d.value),
+    label: d.value_classification,
+    timestamp: new Date(parseInt(d.timestamp) * 1000).toISOString().slice(0, 10),
+  };
+  process.stderr.write(`[coingecko] fearGreed value=${result.value} label=${result.label}\n`);
+  return result;
+}

package/src/data/tencent.ts

@@ -0,0 +1,187 @@
+import axios from "axios";
+import iconv from "iconv-lite";
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+export interface AShareQuote {
+  code: string;
+  name: string;
+  price: number;
+  change: number;
+  changePercent: string;
+  volume: string;
+  marketCap: string;
+}
+
+export interface HKQuote {
+  code: string;
+  name: string;
+  price: number;
+  prevClose: number;
+  open: number;
+  high: number;
+  low: number;
+  volume: string;
+  change: number;
+  changePercent: string;
+  time: string;
+}
+
+export interface KlineBar {
+  date: string;
+  open: number;
+  close: number;
+  high: number;
+  low: number;
+  volume: number;
+}
+
+// ─── URL Builders ─────────────────────────────────────────────────────────────
+
+function aQuoteUrl(code: string) {
+  return `https://qt.gtimg.cn/q=s_${resolveASharePrefix(code)}${code}`;
+}
+
+function hkQuoteUrl(code: string) {
+  return `https://qt.gtimg.cn/q=r_hk${code}`;
+}
+
+function aKlineUrl(code: string, period: string) {
+  return `https://web.ifzq.gtimg.cn/appstock/app/fqkline/get?param=${resolveASharePrefix(code)}${code},${period},,,100,qfq`;
+}
+
+function hkKlineUrl(code: string, period: string) {
+  return `https://web.ifzq.gtimg.cn/appstock/app/fqkline/get?param=hk${code},${period},,,100,qfq`;
+}
+
+// ─── Utils ────────────────────────────────────────────────────────────────────
+
+// 6/5 开头=上证，8/9 开头=北交所，其余=深证
+export function resolveASharePrefix(code: string): "sh" | "sz" | "bj" {
+  const c = code.replace(/^(sh|sz|bj)/i, "");
+  if (/^[56]/.test(c)) return "sh";
+  if (/^[89]/.test(c)) return "bj";
+  return "sz";
+}
+
+function periodParam(period: "daily" | "weekly" | "monthly"): string {
+  return { daily: "day", weekly: "week", monthly: "month" }[period];
+}
+
+// ─── Parsers ──────────────────────────────────────────────────────────────────
+
+function parseAShareQuote(raw: string, code: string): AShareQuote | null {
+  const match = raw.match(/v_s_\w+="([^"]+)"/);
+  if (!match) return null;
+  const f = match[1].split("~");
+  return {
+    code,
+    name: f[1],
+    price: parseFloat(f[3]),
+    change: parseFloat(f[4]),
+    changePercent: f[5] + "%",
+    volume: f[6],
+    marketCap: f[9],
+  };
+}
+
+function parseHKQuote(raw: string, code: string): HKQuote | null {
+  const match = raw.match(/v_r_hk\w+="([^"]+)"/);
+  if (!match) return null;
+  const f = match[1].split("~");
+  return {
+    code,
+    name: f[1],
+    price: parseFloat(f[3]),
+    prevClose: parseFloat(f[4]),
+    open: parseFloat(f[5]),
+    volume: f[6],
+    time: f[30],
+    change: parseFloat(f[31]),
+    changePercent: f[32] + "%",
+    high: parseFloat(f[33]),
+    low: parseFloat(f[34]),
+  };
+}
+
+function parseKline(data: unknown, key: string): KlineBar[] {
+  const d = data as Record<string, unknown>;
+  const dataMap = d?.["data"] as Record<string, unknown> | undefined;
+  const stockData = (dataMap?.[key] ?? {}) as Record<string, unknown>;
+  const raw = (stockData?.["qfqday"] ?? stockData?.["day"] ?? []) as string[][];
+  return raw.slice(-100).map((k) => ({
+    date: k[0],
+    open: parseFloat(k[1]),
+    close: parseFloat(k[2]),
+    high: parseFloat(k[3]),
+    low: parseFloat(k[4]),
+    volume: parseFloat(k[5]),
+  }));
+}
+
+// ─── Fetch Functions ──────────────────────────────────────────────────────────
+
+export async function fetchAShareQuotes(codes: string[]): Promise<AShareQuote[]> {
+  process.stderr.write(`[tencent] fetchAShareQuotes codes=${codes.join(",")}\n`);
+  const results = await Promise.all(
+    codes.map(async (raw) => {
+      const code = raw.replace(/^(sh|sz|bj)/i, "");
+      try {
+        const res = await axios.get(aQuoteUrl(code), { timeout: 5000, responseType: "arraybuffer" });
+        const text = iconv.decode(Buffer.from(res.data), "gbk");
+        const quote = parseAShareQuote(text, code);
+        if (!quote) process.stderr.write(`[tencent] A股解析失败 code=${code}\n`);
+        return quote;
+      } catch (e) {
+        process.stderr.write(`[tencent] A股请求失败 code=${code} err=${e}\n`);
+        return null;
+      }
+    })
+  );
+  return results.filter(Boolean) as AShareQuote[];
+}
+
+export async function fetchHKQuotes(codes: string[]): Promise<HKQuote[]> {
+  process.stderr.write(`[tencent] fetchHKQuotes codes=${codes.join(",")}\n`);
+  const results = await Promise.all(
+    codes.map(async (raw) => {
+      const code = raw.replace(/^hk/i, "").padStart(5, "0");
+      try {
+        const res = await axios.get(hkQuoteUrl(code), { timeout: 5000, responseType: "arraybuffer" });
+        const text = iconv.decode(Buffer.from(res.data), "gbk");
+        const quote = parseHKQuote(text, code);
+        if (!quote) process.stderr.write(`[tencent] 港股解析失败 code=${code}\n`);
+        return quote;
+      } catch (e) {
+        process.stderr.write(`[tencent] 港股请求失败 code=${code} err=${e}\n`);
+        return null;
+      }
+    })
+  );
+  return results.filter(Boolean) as HKQuote[];
+}
+
+export async function fetchAShareKline(
+  code: string,
+  period: "daily" | "weekly" | "monthly" = "daily"
+): Promise<KlineBar[]> {
+  const stripped = code.replace(/^(sh|sz|bj)/i, "");
+  const prefix = resolveASharePrefix(stripped);
+  process.stderr.write(`[tencent] fetchAShareKline code=${stripped} period=${period}\n`);
+  const res = await axios.get(aKlineUrl(stripped, periodParam(period)), { timeout: 5000 });
+  const bars = parseKline(res.data, `${prefix}${stripped}`);
+  process.stderr.write(`[tencent] fetchAShareKline 返回 ${bars.length} 条\n`);
+  return bars;
+}
+
+export async function fetchHKKline(
+  code: string,
+  period: "daily" | "weekly" | "monthly" = "daily"
+): Promise<KlineBar[]> {
+  const normalized = code.replace(/^hk/i, "").padStart(5, "0");
+  process.stderr.write(`[tencent] fetchHKKline code=${normalized} period=${period}\n`);
+  const res = await axios.get(hkKlineUrl(normalized, periodParam(period)), { timeout: 5000 });
+  const bars = parseKline(res.data, `hk${normalized}`);
+  process.stderr.write(`[tencent] fetchHKKline 返回 ${bars.length} 条\n`);
+  return bars;
+}

package/src/data/yahoo.ts

@@ -0,0 +1,139 @@
+import { default as YahooFinance } from "yahoo-finance2";
+
+// v3 需要实例化
+const yf = new YahooFinance({ suppressNotices: ["yahooSurvey"] });
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+export interface USQuote {
+  symbol: string;
+  name: string;
+  price: number;
+  change: number;
+  changePercent: string;
+  open: number;
+  high: number;
+  low: number;
+  prevClose: number;
+  volume: number;
+  marketCap: number | null;
+  currency: string;
+  exchange: string;
+}
+
+export interface USKlineBar {
+  date: string;
+  open: number;
+  high: number;
+  low: number;
+  close: number;
+  volume: number;
+  adjClose: number | null;
+}
+
+export interface StockProfile {
+  symbol: string;
+  name: string;
+  sector: string | null;
+  industry: string | null;
+  description: string | null;
+  website: string | null;
+  employees: number | null;
+  country: string | null;
+  currency: string;
+  marketCap: number | null;
+  pe: number | null;
+  eps: number | null;
+  beta: number | null;
+  fiftyTwoWeekHigh: number | null;
+  fiftyTwoWeekLow: number | null;
+}
+
+// ─── Fetch Functions ──────────────────────────────────────────────────────────
+
+export async function fetchUSQuotes(symbols: string[]): Promise<USQuote[]> {
+  process.stderr.write(`[yahoo] fetchUSQuotes symbols=${symbols.join(",")}\n`);
+  const results = await Promise.all(
+    symbols.map(async (symbol) => {
+      try {
+        const q = await yf.quote(symbol);
+        const result: USQuote = {
+          symbol: q.symbol,
+          name: (q as Record<string, unknown>).longName as string ?? (q as Record<string, unknown>).shortName as string ?? symbol,
+          price: q.regularMarketPrice ?? 0,
+          change: q.regularMarketChange ?? 0,
+          changePercent: ((q.regularMarketChangePercent ?? 0).toFixed(2)) + "%",
+          open: q.regularMarketOpen ?? 0,
+          high: q.regularMarketDayHigh ?? 0,
+          low: q.regularMarketDayLow ?? 0,
+          prevClose: q.regularMarketPreviousClose ?? 0,
+          volume: q.regularMarketVolume ?? 0,
+          marketCap: (q as Record<string, unknown>).marketCap as number ?? null,
+          currency: q.currency ?? "USD",
+          exchange: (q as Record<string, unknown>).fullExchangeName as string ?? q.exchange ?? "",
+        };
+        process.stderr.write(`[yahoo] ${symbol} price=${result.price}\n`);
+        return result;
+      } catch (e) {
+        process.stderr.write(`[yahoo] 请求失败 symbol=${symbol} err=${e}\n`);
+        return null;
+      }
+    })
+  );
+  return results.filter(Boolean) as USQuote[];
+}
+
+export async function fetchUSKlines(
+  symbol: string,
+  startDate: string,  // YYYY-MM-DD
+  endDate: string,    // YYYY-MM-DD
+  interval: "1d" | "1wk" | "1mo" = "1d"
+): Promise<USKlineBar[]> {
+  process.stderr.write(`[yahoo] fetchUSKlines symbol=${symbol} start=${startDate} end=${endDate} interval=${interval}\n`);
+  const rows = await yf.historical(symbol, {
+    period1: startDate,
+    period2: endDate,
+    interval,
+  });
+  const bars: USKlineBar[] = rows.map((r) => ({
+    date: r.date.toISOString().slice(0, 10),
+    open: r.open ?? 0,
+    high: r.high ?? 0,
+    low: r.low ?? 0,
+    close: r.close ?? 0,
+    volume: r.volume ?? 0,
+    adjClose: r.adjClose ?? null,
+  }));
+  process.stderr.write(`[yahoo] fetchUSKlines 返回 ${bars.length} 条\n`);
+  return bars;
+}
+
+export async function fetchStockProfile(symbol: string): Promise<StockProfile> {
+  process.stderr.write(`[yahoo] fetchStockProfile symbol=${symbol}\n`);
+  const summary = await yf.quoteSummary(symbol, {
+    modules: ["price", "summaryProfile", "defaultKeyStatistics"],
+  });
+  const price = summary.price as Record<string, unknown> | undefined;
+  const profile = summary.summaryProfile as Record<string, unknown> | undefined;
+  const stats = summary.defaultKeyStatistics as Record<string, unknown> | undefined;
+
+  const result: StockProfile = {
+    symbol,
+    name: price?.longName as string ?? price?.shortName as string ?? symbol,
+    sector: profile?.sector as string ?? null,
+    industry: profile?.industry as string ?? null,
+    description: profile?.longBusinessSummary as string ?? null,
+    website: profile?.website as string ?? null,
+    employees: profile?.fullTimeEmployees as number ?? null,
+    country: profile?.country as string ?? null,
+    currency: price?.currency as string ?? "USD",
+    marketCap: price?.marketCap as number ?? null,
+    pe: price?.trailingPE as number ?? null,
+    eps: stats?.trailingEps as number ?? null,
+    beta: stats?.beta as number ?? null,
+    fiftyTwoWeekHigh: price?.fiftyTwoWeekHigh as number ?? null,
+    fiftyTwoWeekLow: price?.fiftyTwoWeekLow as number ?? null,
+  };
+  process.stderr.write(`[yahoo] fetchStockProfile ${symbol} sector=${result.sector}\n`);
+  return result;
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { startServer } from "./server";
+
+startServer().catch((e) => {
+  process.stderr.write(`[stock-mcp] fatal: ${e}\n`);
+  process.exit(1);
+});

package/src/server.ts

@@ -0,0 +1,40 @@
+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 { tools, toolMap } from "./tools/index";
+
+const server = new Server(
+  { name: "stock-mcp", version: "1.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+// 返回所有已注册的 tools 列表
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: tools.map((t) => t.tool) as any,
+}));
+
+// 路由到对应 tool handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const def = toolMap.get(name);
+  if (!def) {
+    return {
+      content: [{ type: "text" as const, text: `Unknown tool: ${name}` }],
+      isError: true,
+    };
+  }
+  return def.handler((args ?? {}) as Record<string, unknown>) as any;
+});
+
+export async function startServer(): Promise<void> {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  process.stderr.write(`[stock-mcp] server started — ${tools.length} tools registered\n`);
+  for (const t of tools) {
+    process.stderr.write(`  · ${t.tool.name}\n`);
+  }
+}