market-data-analyzer 2.1.0 → 2.1.1

package/src/index.ts

@@ -1,393 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Market Data Analyzer -- MCP Server
- *
- * Finance-focused MCP server with live data from Yahoo Finance and CoinGecko.
- * Tools: analyze_stock, screen_stocks, analyze_portfolio, compare_assets,
- *        market_overview, crypto_analysis.
- *
- * Transports: stdio (default) or SSE (--sse flag).
- */
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
-import { z } from "zod";
-import http from "node:http";
-
-import { handleAnalyzeStock } from "./tools/analyze_stock.js";
-import { handleScreenStocks } from "./tools/screen_stocks.js";
-import { handleAnalyzePortfolio } from "./tools/analyze_portfolio.js";
-import { handleCompareAssets } from "./tools/compare_assets.js";
-import { handleMarketOverview } from "./tools/market_overview.js";
-import { handleCryptoAnalysis } from "./tools/crypto_analysis.js";
-import { checkLicense } from "./license.js";
-
-// ---------------------------------------------------------------------------
-// Tool registration helper (reused for per-session servers in SSE mode)
-// ---------------------------------------------------------------------------
-
-function registerTools(server: McpServer): void {
-
-// ---------------------------------------------------------------------------
-// Tool: analyze_stock
-// ---------------------------------------------------------------------------
-
-server.tool(
-  "analyze_stock",
-  "Deep analysis of a stock symbol: price, moving averages (SMA 20/50/200), RSI, MACD, support/resistance levels. Uses live Yahoo Finance data.",
-  {
-    symbol: z
-      .string()
-      .describe("Stock ticker symbol (e.g. 'AAPL', 'MSFT', 'TSLA')"),
-  },
-  async ({ symbol }) => {
-    const license = checkLicense("market-data-analyzer");
-    if (!license.valid) {
-      return { content: [{ type: "text" as const, text: license.message ?? "License required" }], isError: true };
-    }
-    try {
-      const result = await handleAnalyzeStock(symbol.toUpperCase());
-      const content = [{ type: "text" as const, text: result }];
-      if (license.trial && license.message) {
-        content.push({ type: "text" as const, text: "\n\n" + license.message });
-      }
-      return { content };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `Error analyzing ${symbol}: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-// ---------------------------------------------------------------------------
-// Tool: screen_stocks
-// ---------------------------------------------------------------------------
-
-server.tool(
-  "screen_stocks",
-  "Screen stocks by criteria: market cap range, P/E ratio, sector, volume threshold. Returns top matches with key metrics. Fetches live data from Yahoo Finance for ~70 popular stocks.",
-  {
-    min_market_cap: z
-      .number()
-      .optional()
-      .describe("Minimum market cap in USD (e.g. 1000000000 for $1B)"),
-    max_market_cap: z.number().optional().describe("Maximum market cap in USD"),
-    min_pe: z.number().optional().describe("Minimum trailing P/E ratio"),
-    max_pe: z.number().optional().describe("Maximum trailing P/E ratio"),
-    sector: z
-      .string()
-      .optional()
-      .describe("Sector filter (partial match, e.g. 'tech', 'health', 'energy')"),
-    min_volume: z.number().optional().describe("Minimum daily trading volume"),
-    min_price: z.number().optional().describe("Minimum stock price"),
-    max_price: z.number().optional().describe("Maximum stock price"),
-    limit: z
-      .number()
-      .int()
-      .min(1)
-      .max(50)
-      .optional()
-      .describe("Max results to return (default: 25)"),
-  },
-  async (criteria) => {
-    const license = checkLicense("market-data-analyzer");
-    if (!license.valid) {
-      return { content: [{ type: "text" as const, text: license.message ?? "License required" }], isError: true };
-    }
-    try {
-      const result = await handleScreenStocks(criteria);
-      const content = [{ type: "text" as const, text: result }];
-      if (license.trial && license.message) {
-        content.push({ type: "text" as const, text: "\n\n" + license.message });
-      }
-      return { content };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `Error screening stocks: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-// ---------------------------------------------------------------------------
-// Tool: analyze_portfolio
-// ---------------------------------------------------------------------------
-
-server.tool(
-  "analyze_portfolio",
-  "Analyze a portfolio of holdings. Provide positions with symbol, shares, and average cost. Returns total value, P&L per position, allocation %, diversification score, and risk metrics. Fetches live prices from Yahoo Finance.",
-  {
-    holdings: z
-      .array(
-        z.object({
-          symbol: z.string().describe("Ticker symbol (e.g. 'AAPL')"),
-          shares: z.number().describe("Number of shares held"),
-          avg_cost: z.number().describe("Average cost per share"),
-        }),
-      )
-      .min(1)
-      .describe("Array of portfolio holdings"),
-  },
-  async ({ holdings }) => {
-    const license = checkLicense("market-data-analyzer");
-    if (!license.valid) {
-      return { content: [{ type: "text" as const, text: license.message ?? "License required" }], isError: true };
-    }
-    try {
-      const result = await handleAnalyzePortfolio(holdings);
-      const content = [{ type: "text" as const, text: result }];
-      if (license.trial && license.message) {
-        content.push({ type: "text" as const, text: "\n\n" + license.message });
-      }
-      return { content };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `Error analyzing portfolio: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-// ---------------------------------------------------------------------------
-// Tool: compare_assets
-// ---------------------------------------------------------------------------
-
-server.tool(
-  "compare_assets",
-  "Compare 2-5 assets side by side: returns, volatility, correlation, Sharpe ratio approximation over a given period. Uses Yahoo Finance historical data.",
-  {
-    symbols: z
-      .array(z.string())
-      .min(2)
-      .max(5)
-      .describe("Array of 2-5 ticker symbols to compare (e.g. ['AAPL', 'MSFT', 'GOOGL'])"),
-    period: z
-      .enum(["1mo", "3mo", "6mo", "1y", "2y", "5y"])
-      .optional()
-      .describe("Comparison period (default: '6mo')"),
-  },
-  async ({ symbols, period }) => {
-    const license = checkLicense("market-data-analyzer");
-    if (!license.valid) {
-      return { content: [{ type: "text" as const, text: license.message ?? "License required" }], isError: true };
-    }
-    try {
-      const result = await handleCompareAssets(
-        symbols.map((s) => s.toUpperCase()),
-        period ?? "6mo",
-      );
-      const content = [{ type: "text" as const, text: result }];
-      if (license.trial && license.message) {
-        content.push({ type: "text" as const, text: "\n\n" + license.message });
-      }
-      return { content };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `Error comparing assets: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-// ---------------------------------------------------------------------------
-// Tool: market_overview
-// ---------------------------------------------------------------------------
-
-server.tool(
-  "market_overview",
-  "Current market snapshot: major indices (S&P 500, NASDAQ, DOW), sector performance via ETFs, market breadth indicators, VIX, crypto, and commodities. Live data from Yahoo Finance.",
-  {},
-  async () => {
-    const license = checkLicense("market-data-analyzer");
-    if (!license.valid) {
-      return { content: [{ type: "text" as const, text: license.message ?? "License required" }], isError: true };
-    }
-    try {
-      const result = await handleMarketOverview();
-      const content = [{ type: "text" as const, text: result }];
-      if (license.trial && license.message) {
-        content.push({ type: "text" as const, text: "\n\n" + license.message });
-      }
-      return { content };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `Error fetching market overview: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-// ---------------------------------------------------------------------------
-// Tool: crypto_analysis
-// ---------------------------------------------------------------------------
-
-server.tool(
-  "crypto_analysis",
-  "Crypto-specific analysis: price, 24h volume, market dominance, fear/greed index approximation, supply metrics, ATH/ATL data. Uses CoinGecko free API.",
-  {
-    symbol: z
-      .string()
-      .describe("Cryptocurrency symbol or name (e.g. 'BTC', 'ETH', 'SOL', 'bitcoin')"),
-  },
-  async ({ symbol }) => {
-    const license = checkLicense("market-data-analyzer");
-    if (!license.valid) {
-      return { content: [{ type: "text" as const, text: license.message ?? "License required" }], isError: true };
-    }
-    try {
-      const result = await handleCryptoAnalysis(symbol);
-      const content = [{ type: "text" as const, text: result }];
-      if (license.trial && license.message) {
-        content.push({ type: "text" as const, text: "\n\n" + license.message });
-      }
-      return { content };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `Error analyzing crypto ${symbol}: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-}
-
-// ---------------------------------------------------------------------------
-// Server setup (for stdio mode)
-// ---------------------------------------------------------------------------
-
-function createServer(): McpServer {
-  const s = new McpServer({
-    name: "market-data-analyzer",
-    version: "2.0.0",
-  });
-  registerTools(s);
-  return s;
-}
-
-// ---------------------------------------------------------------------------
-// Transport: stdio or SSE
-// ---------------------------------------------------------------------------
-
-async function main(): Promise<void> {
-  const useSSE = process.argv.includes("--sse");
-
-  if (useSSE) {
-    const port = parseInt(process.env.PORT ?? "3000", 10);
-    const transports = new Map<string, SSEServerTransport>();
-
-    const httpServer = http.createServer(async (req, res) => {
-      // CORS headers
-      res.setHeader("Access-Control-Allow-Origin", "*");
-      res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
-      res.setHeader("Access-Control-Allow-Headers", "Content-Type");
-
-      if (req.method === "OPTIONS") {
-        res.writeHead(204);
-        res.end();
-        return;
-      }
-
-      const url = new URL(req.url ?? "/", `http://localhost:${port}`);
-
-      if (url.pathname === "/sse" && req.method === "GET") {
-        const transport = new SSEServerTransport("/messages", res);
-        const sessionId = transport.sessionId;
-        transports.set(sessionId, transport);
-
-        res.on("close", () => {
-          transports.delete(sessionId);
-        });
-
-        // Each SSE session gets its own McpServer instance
-        const sessionServer = createServer();
-        await sessionServer.connect(transport);
-        return;
-      }
-
-      if (url.pathname === "/messages" && req.method === "POST") {
-        const sessionId = url.searchParams.get("sessionId");
-        if (!sessionId || !transports.has(sessionId)) {
-          res.writeHead(400, { "Content-Type": "application/json" });
-          res.end(JSON.stringify({ error: "Invalid or missing sessionId" }));
-          return;
-        }
-        const transport = transports.get(sessionId)!;
-        await transport.handlePostMessage(req, res);
-        return;
-      }
-
-      if (url.pathname === "/health") {
-        res.writeHead(200, { "Content-Type": "application/json" });
-        res.end(
-          JSON.stringify({
-            status: "ok",
-            server: "market-data-analyzer",
-            version: "2.0.0",
-          }),
-        );
-        return;
-      }
-
-      res.writeHead(404, { "Content-Type": "application/json" });
-      res.end(JSON.stringify({ error: "Not found" }));
-    });
-
-    httpServer.listen(port, () => {
-      console.error(
-        `Market Data Analyzer MCP server (SSE) listening on port ${port}`,
-      );
-      console.error(`  SSE endpoint: http://localhost:${port}/sse`);
-      console.error(`  Messages endpoint: http://localhost:${port}/messages`);
-      console.error(`  Health check: http://localhost:${port}/health`);
-    });
-  } else {
-    const server = createServer();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error("Market Data Analyzer MCP server running on stdio");
-  }
-}
-
-main().catch((err) => {
-  console.error("Fatal error:", err);
-  process.exit(1);
-});

package/src/license.ts

@@ -1,143 +0,0 @@
-/**
- * Shared license validation for AIVP MCP servers.
- *
- * License keys are HMAC-SHA256 signed strings in the format:
- *   base64(email:product:expiry):signature
- *
- * The server validates locally — no network call needed.
- *
- * Without a key, users get a free trial (limited calls).
- * With a valid key, usage is unlimited.
- */
-
-import { createHmac } from "node:crypto";
-
-// This secret is used to sign/verify license keys.
-// In production, this should be injected via env var, but for local
-// validation of HMAC-signed keys, it must be embedded.
-const LICENSE_SECRET = process.env.AIVP_LICENSE_SECRET ?? "aivp-mcp-2026-s3cr3t-k3y";
-
-const FREE_TRIAL_LIMIT = 3;
-
-// In-memory call counter for free trial
-const callCounts = new Map<string, number>();
-
-export interface LicenseResult {
-  valid: boolean;
-  message?: string;
-  trial?: boolean;
-  remaining?: number;
-}
-
-/**
- * Generate a license key for a given email and product.
- * Used by the key generation script, not by the server itself.
- */
-export function generateLicenseKey(
-  email: string,
-  product: string,
-  expiryDays: number = 365,
-): string {
-  const expiry = new Date(
-    Date.now() + expiryDays * 24 * 60 * 60 * 1000,
-  ).toISOString().split("T")[0];
-  const payload = `${email}:${product}:${expiry}`;
-  const payloadB64 = Buffer.from(payload).toString("base64url");
-  const signature = createHmac("sha256", LICENSE_SECRET)
-    .update(payload)
-    .digest("base64url");
-  return `${payloadB64}.${signature}`;
-}
-
-/**
- * Validate a license key for a given product.
- * Returns { valid: true } if the key is valid for this product.
- */
-export function validateLicenseKey(
-  key: string,
-  product: string,
-): LicenseResult {
-  try {
-    const [payloadB64, signature] = key.split(".");
-    if (!payloadB64 || !signature) {
-      return { valid: false, message: "Invalid key format" };
-    }
-
-    const payload = Buffer.from(payloadB64, "base64url").toString("utf-8");
-    const [email, keyProduct, expiry] = payload.split(":");
-
-    if (!email || !keyProduct || !expiry) {
-      return { valid: false, message: "Invalid key format" };
-    }
-
-    // Verify signature
-    const expectedSignature = createHmac("sha256", LICENSE_SECRET)
-      .update(payload)
-      .digest("base64url");
-
-    if (signature !== expectedSignature) {
-      return { valid: false, message: "Invalid license key" };
-    }
-
-    // Check product match (allow "all" for bundle keys)
-    if (keyProduct !== product && keyProduct !== "all") {
-      return {
-        valid: false,
-        message: `This key is for "${keyProduct}", not "${product}"`,
-      };
-    }
-
-    // Check expiry
-    const expiryDate = new Date(expiry);
-    if (isNaN(expiryDate.getTime()) || expiryDate < new Date()) {
-      return { valid: false, message: "License key has expired" };
-    }
-
-    return { valid: true };
-  } catch {
-    return { valid: false, message: "Invalid license key" };
-  }
-}
-
-/**
- * Check if the current call is allowed.
- * Call this at the start of every tool handler.
- *
- * - If LICENSE_KEY env var is set and valid: always allowed
- * - If no key: allowed for FREE_TRIAL_LIMIT calls, then blocked
- */
-export function checkLicense(product: string): LicenseResult {
-  const key = process.env.LICENSE_KEY ?? process.env.AIVP_LICENSE_KEY;
-
-  if (key) {
-    const result = validateLicenseKey(key, product);
-    if (result.valid) {
-      return { valid: true };
-    }
-    // Invalid key — still return the error, don't fall through to trial
-    return result;
-  }
-
-  // No key — free trial mode
-  const count = (callCounts.get(product) ?? 0) + 1;
-  callCounts.set(product, count);
-
-  if (count <= FREE_TRIAL_LIMIT) {
-    return {
-      valid: true,
-      trial: true,
-      remaining: FREE_TRIAL_LIMIT - count,
-      message:
-        count === FREE_TRIAL_LIMIT
-          ? `⚠️ Free trial ended. Purchase a license at https://aivp-mcp.vercel.app`
-          : `Free trial: ${FREE_TRIAL_LIMIT - count} calls remaining. Get unlimited access at https://aivp-mcp.vercel.app`,
-    };
-  }
-
-  return {
-    valid: false,
-    trial: true,
-    remaining: 0,
-    message: `🔒 Free trial limit reached (${FREE_TRIAL_LIMIT} calls). Purchase a license at https://aivp-mcp.vercel.app to continue using this tool.`,
-  };
-}