stockquotes-mcp 1.0.3

package/dist/transports/TransportStrategy.d.ts

@@ -0,0 +1,24 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Transport Strategy Interface
+ * Defines the contract for different transport implementations
+ */
+export interface TransportStrategy {
+    /**
+     * Connect the server using the specific transport
+     */
+    connect(): Promise<void>;
+    /**
+     * Get the transport type
+     */
+    getType(): string;
+    /**
+     * Get the server instance for tool registration
+     */
+    getServer(): McpServer;
+    /**
+     * Close the server and cleanup resources
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=TransportStrategy.d.ts.map

package/dist/transports/TransportStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportStrategy.d.ts","sourceRoot":"","sources":["../../src/transports/TransportStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,IAAI,SAAS,CAAC;IAEvB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/transports/TransportStrategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TransportStrategy.js.map

package/dist/transports/TransportStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportStrategy.js","sourceRoot":"","sources":["../../src/transports/TransportStrategy.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+export declare const StockQuoteSchema: z.ZodObject<{
+    ticker: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type StockQuoteInput = z.infer<typeof StockQuoteSchema>;
+export interface StockQuoteResponse {
+    symbol: string;
+    name?: string;
+    exchange?: string;
+    currency?: string;
+    regularMarketPrice?: number;
+    regularMarketChange?: number;
+    regularMarketChangePercent?: number;
+    regularMarketVolume?: number;
+    marketCap?: number;
+    fiftyTwoWeekLow?: number;
+    fiftyTwoWeekHigh?: number;
+    averageDailyVolume3Month?: number;
+    trailingPE?: number;
+    forwardPE?: number;
+    dividendYield?: number;
+    epsTrailingTwelveMonths?: number;
+    epsForward?: number;
+    bookValue?: number;
+    priceToBook?: number;
+    marketState?: string;
+    quoteType?: string;
+    [key: string]: unknown;
+}
+export interface StockSearchResult {
+    symbol: string;
+    name: string;
+    exchange: string;
+}
+export interface HistoricalData {
+    date: string;
+    close: number;
+    high: number;
+    low: number;
+    volume: number;
+}
+export type TransportType = 'stdio' | 'http';
+export interface ServerConfig {
+    name: string;
+    version: string;
+    transport: TransportType;
+    httpPort?: number;
+    httpHost?: string;
+}
+export interface YahooQuote {
+    symbol?: string;
+    shortName?: string;
+    longName?: string;
+    exchange?: string;
+    currency?: string;
+    regularMarketPrice?: number;
+    regularMarketChange?: number;
+    regularMarketChangePercent?: number;
+    regularMarketVolume?: number;
+    marketCap?: number;
+    fiftyTwoWeekLow?: number;
+    fiftyTwoWeekHigh?: number;
+    averageDailyVolume3Month?: number;
+    trailingPE?: number;
+    forwardPE?: number;
+    dividendYield?: number;
+    epsTrailingTwelveMonths?: number;
+    epsForward?: number;
+    bookValue?: number;
+    priceToBook?: number;
+    marketState?: string;
+    quoteType?: string;
+    [key: string]: unknown;
+}
+export interface YahooSearchQuote {
+    symbol?: string;
+    shortname?: string;
+    longname?: string;
+    exchange?: string;
+    [key: string]: unknown;
+}
+export interface YahooSearchResponse {
+    quotes?: YahooSearchQuote[];
+    [key: string]: unknown;
+}
+export interface YahooHistoricalQuote {
+    date?: number | Date;
+    open?: number;
+    high?: number;
+    low?: number;
+    close?: number;
+    adjClose?: number;
+    volume?: number;
+    [key: string]: unknown;
+}
+export interface YahooChartResponse {
+    quotes?: YahooHistoricalQuote[];
+    meta?: {
+        symbol?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+// Schema for stock quote tool input
+export const StockQuoteSchema = z.object({
+    ticker: z
+        .string()
+        .min(1)
+        .max(10)
+        .toUpperCase()
+        .describe('Stock ticker symbol (e.g., AAPL, GOOGL, MSFT)'),
+    fields: z.array(z.string()).optional().describe('Optional list of specific fields to return'),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oCAAoC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,WAAW,EAAE;SACb,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC9F,CAAC,CAAC"}

package/dist/yahooFinanceClient.d.ts

@@ -0,0 +1,14 @@
+import type { YahooChartResponse, YahooQuote, YahooSearchResponse } from './types.js';
+export interface YahooClient {
+    quote(symbol: string, options?: object): Promise<YahooQuote | YahooQuote[]>;
+    search(query: string, options?: unknown, moduleOptions?: object): Promise<YahooSearchResponse>;
+    chart(symbol: string, options?: unknown, moduleOptions?: object): Promise<YahooChartResponse>;
+}
+export declare class YahooFinanceClient implements YahooClient {
+    private client;
+    constructor(client?: unknown);
+    quote(symbol: string, options?: object): Promise<YahooQuote | YahooQuote[]>;
+    search(query: string, options?: unknown, moduleOptions?: object): Promise<YahooSearchResponse>;
+    chart(symbol: string, options?: unknown, moduleOptions?: object): Promise<YahooChartResponse>;
+}
+//# sourceMappingURL=yahooFinanceClient.d.ts.map

package/dist/yahooFinanceClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yahooFinanceClient.d.ts","sourceRoot":"","sources":["../src/yahooFinanceClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC,CAAC;IAC5E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC/F,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/F;AAED,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,MAAM,CAAU;gBAEZ,MAAM,CAAC,EAAE,OAAO;IAItB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC;IAQ3E,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC;IAOzB,KAAK,CACT,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,CAAC;CAM/B"}

package/dist/yahooFinanceClient.js

@@ -0,0 +1,20 @@
+import YahooFinance from 'yahoo-finance2';
+export class YahooFinanceClient {
+    client;
+    constructor(client) {
+        this.client = client ?? new YahooFinance();
+    }
+    async quote(symbol, options) {
+        const result = await this.client.quote(symbol, options);
+        return result;
+    }
+    async search(query, options, moduleOptions) {
+        const result = await this.client.search(query, options, moduleOptions);
+        return result;
+    }
+    async chart(symbol, options, moduleOptions) {
+        const result = await this.client.chart(symbol, options, moduleOptions);
+        return result;
+    }
+}
+//# sourceMappingURL=yahooFinanceClient.js.map

package/dist/yahooFinanceClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yahooFinanceClient.js","sourceRoot":"","sources":["../src/yahooFinanceClient.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAS1C,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAU;IAExB,YAAY,MAAgB;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,OAAgB;QAC1C,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,MAA6D,CAAC,KAAK,CAC5F,MAAM,EACN,OAAO,CACR,CAAC;QACF,OAAO,MAAmC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAAiB,EACjB,aAAsB;QAEtB,MAAM,MAAM,GAAG,MACb,IAAI,CAAC,MACN,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QACxC,OAAO,MAA6B,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,KAAK,CACT,MAAc,EACd,OAAiB,EACjB,aAAsB;QAEtB,MAAM,MAAM,GAAG,MACb,IAAI,CAAC,MACN,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QACxC,OAAO,MAA4B,CAAC;IACtC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "stockquotes-mcp",
+  "version": "1.0.3",
+  "description": "MCP Server for fetching stock quotes from Yahoo Finance",
+  "author": "Lionel Schiepers <lionel_schiepers@hotmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lionelschiepers/StockQuotes.MCP.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lionelschiepers/StockQuotes.MCP/issues"
+  },
+  "homepage": "https://github.com/lionelschiepers/StockQuotes.MCP#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "types": "dist/index.d.ts",
+  "bin": {
+    "stock-quotes-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:watch": "jest --watch",
+    "start": "node dist/index.js",
+    "start:stdio": "node dist/index.js --transport stdio",
+    "start:http": "node dist/index.js --transport http --http-host localhost",
+    "dev": "tsx watch src/index.ts --transport stdio",
+    "clean": "rm -rf dist",
+    "inspect": "tsc && npx -y @modelcontextprotocol/inspector node dist/index.js",
+    "prepare": "husky",
+    "prepublishOnly": "npm run build && npm run test",
+    "publish": "npm publish",
+    "publish:dry": "npm publish --dry-run"
+  },
+  "keywords": [
+    "mcp",
+    "stock-quotes",
+    "yahoo-finance",
+    "mcp-server",
+    "ai-tools",
+    "financial data",
+    "finance",
+    "api"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "date-fns": "^4.1.0",
+    "express": "^5.2.1",
+    "yahoo-finance2": "^3.11.2",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.8",
+    "@types/supertest": "^6.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "npm-check-updates": "^19.3.1",
+    "prettier": "^3.7.4",
+    "supertest": "^7.2.2",
+    "ts-jest": "^29.4.6",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}