stockquotes-mcp 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lionel Schiepers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,257 @@
+# 📈 MCP Stock Quotes Server
+
+[![CI](https://github.com/lionelschiepers/StockQuotes.MCP/actions/workflows/build.yml/badge.svg)](https://github.com/lionelschiepers/StockQuotes.MCP/actions/workflows/build.yml)
+[![Code Coverage](https://codecov.io/github/lionelschiepers/StockQuotes.MCP/graph/badge.svg?token=GSD4M589HB)](https://codecov.io/github/lionelschiepers/StockQuotes.MCP)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
+[![Model Context Protocol](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io/)
+
+**Empower your AI assistants with real-time financial market data.**
+
+This **Model Context Protocol (MCP)** server seamlessly bridges the gap between LLMs (like Claude, Gemini, etc.) and Yahoo Finance, enabling intelligent agents to access, analyze, and discuss live stock market trends, historical data, and financial metrics.
+
+---
+
+## 📖 Table of Contents
+
+- [Why Use This?](#-why-use-this)
+- [Features](#-features)
+- [Quick Start](#-quick-start)
+- [Installation](#-installation)
+- [Usage](#-usage)
+- [Available Tools](#-available-mcp-tools)
+- [Example Interaction](#-example-interaction)
+- [Integration Guide](#-integration-with-ai-platforms)
+  - [Cline](#cline)
+  - [Gemini CLI](#gemini-cli)
+- [Docker Support](#-docker-usage)
+- [Development](#-development)
+- [License](#-license)
+
+---
+
+## 💡 Why Use This?
+
+AI models are powerful, but they often lack real-time knowledge. By connecting them to this MCP server, you unlock their ability to:
+
+*   **Analyze Market Trends**: "Compare the P/E ratio of Apple vs. Microsoft."
+*   **Track Portfolios**: "What is the current value of 10 shares of NVDA?"
+*   **Research Companies**: "Get me the latest market cap and 52-week range for Tesla."
+*   **Contextualize News**: "How did the latest earnings report affect Google's stock price today?"
+
+It transforms your AI from a static text generator into a dynamic financial analyst.
+
+## 🚀 Features
+
+*   **Real-time Data**: Instant access to prices, volume, market cap, and more via Yahoo Finance.
+*   **Dual Transport**: Supports `stdio` (for local CLIs) and `SSE/HTTP` (for remote/web clients).
+*   **Smart Search**: Fuzzy search for stocks by company name or ticker symbol.
+*   **Multi-Asset Support**: Works with Stocks, ETFs, Cryptocurrencies, and Indices.
+*   **Type-Safe**: Built with 100% TypeScript for reliability.
+*   **Production Ready**: Includes Docker support, CI/CD pipelines, and comprehensive testing.
+
+## ⚡ Quick Start
+
+For those who want to get up and running immediately:
+
+```bash
+# Clone and Install
+git clone https://github.com/lionelschiepers/StockQuotes.MCP.git
+cd StockQuotes.MCP
+npm install
+
+# Build
+npm run build
+
+# Start (Stdio Mode - default for most MCP clients)
+npm run start:stdio
+```
+
+## 🛠 Installation
+
+### Prerequisites
+
+*   Node.js 22.0.0 or higher (LTS)
+*   npm 9.0.0 or higher
+
+### Step-by-Step
+
+1.  **Clone the repository**
+    ```bash
+    git clone https://github.com/lionelschiepers/StockQuotes.MCP.git
+    cd StockQuotes.MCP
+    ```
+
+2.  **Install dependencies**
+    ```bash
+    npm install
+    ```
+
+3.  **Build the project**
+    ```bash
+    npm run build
+    ```
+
+## 🚦 Usage
+
+### Command Line Options
+
+| Command | Description |
+| :--- | :--- |
+| `npm run start:stdio` | Starts server with Standard I/O transport (Best for local AI agents). |
+| `npm run start:http` | Starts server with HTTP transport on port 3000. |
+| `npm run dev` | Runs in development mode with hot-reloading. |
+
+### Available MCP Tools
+
+Your AI agent will have access to the following tools:
+
+#### 1. `get_stock_quote`
+Fetches detailed financial data for a specific ticker.
+
+*   **Example Prompt:** "What is the price of AAPL?"
+*   **Returns:** Price, Currency, Market Cap, Exchange, etc.
+
+#### 2. `search_stocks`
+Finds ticker symbols based on company names.
+
+*   **Example Prompt:** "Find the ticker for 'Hims & Hers'."
+*   **Returns:** List of matching symbols and names.
+
+#### 3. `get_historical_data`
+Fetches historical stock data for a specific date range.
+
+*   **Example Prompt:** "Get AAPL historical data from 2024-01-01 to 2024-01-31."
+*   **Returns:** Array of daily prices including date, close, high, low, and volume.
+
+## 💬 Example Interaction
+
+Here is a real-world example of how an AI assistant (like Gemini) uses this MCP server to perform data analysis:
+
+**User Prompt:**
+> "Using stock-quotes: Calculate the average price of AAPL for the last 200, 50 and 20 days. Output is {[{days, average}]}. Keep only 2 decimals for the numbers."
+
+**AI Response:**
+```json
+[
+  {
+    "days": 200,
+    "average": 233.12
+  },
+  {
+    "days": 50,
+    "average": 272.62
+  },
+  {
+    "days": 20,
+    "average": 270.57
+  }
+]
+```
+
+![Example Interaction](README.sample1.png)
+
+## 🤖 Integration with AI Platforms
+
+### Cline
+
+To use with [Cline](https://github.com/cline/cline), add this to your MCP settings file:
+
+```json
+{
+  "mcpServers": {
+    "stock-quotes": {
+      "command": "node",
+      "args": ["/absolute/path/to/StockQuotes.MCP/dist/index.js", "--transport", "stdio"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Gemini CLI
+
+Integrate with the Gemini CLI tool using one of these methods:
+
+**Method 1: Direct Command**
+```bash
+gemini mcp add stock-quotes node "C:\Path\To\StockQuotes.MCP\dist\index.js --transport stdio"
+```
+
+**Method 2: Settings Configuration**
+Edit your `~/.gemini/settings.json`:
+
+```json
+// CLI
+{
+  "mcpServers": {
+    "stock-quotes": {
+      "command": "node",
+      "args": [
+        "./dist/index.js", 
+        "--transport",
+        "stdio"
+      ]
+    }  
+  }
+}
+```
+
+
+```json
+// HTTP
+{
+  "mcpServers": {
+    "stock-quotes": {
+      "httpUrl": "http://servername:port/mcp",
+      "headers": {
+        "Accept": "application/json, text/event-stream"
+      }
+    }  
+  }
+}
+```
+
+## 🐳 Docker Usage
+
+Run the server in an isolated container.
+
+**Build:**
+```bash
+docker build -t stockquotes-mcp:latest .
+```
+
+**Run (HTTP Mode):**
+```bash
+docker run -p 3000:3000 stockquotes-mcp:latest
+```
+
+## 💻 Development
+
+### Project Structure
+```
+StockQuotes.MCP/
+├── src/               # Source code
+├── tests/             # Jest tests
+├── .github/           # CI/CD Workflows
+└── ...
+```
+
+### Quality Checks
+*   **Test:** `npm test`
+*   **Lint:** `npm run lint`
+*   **Format:** `npm run format`
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+*   [Yahoo Finance2](https://github.com/gadicc/yahoo-finance2) API wrapper.
+*   [Model Context Protocol](https://modelcontextprotocol.io/) standard.
+
+---
+
+*Disclaimer: This tool is for educational purposes. Data provided by Yahoo Finance may be delayed. Validate all financial data before making investment decisions.*

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Main entry point for the MCP Stock Quotes Server
+ *
+ * This server provides tools for fetching stock quotes from Yahoo Finance
+ * through the Model Context Protocol (MCP).
+ *
+ * Usage:
+ *   node dist/index.js --transport stdio    # Start with stdio transport
+ *   node dist/index.js --transport http     # Start with HTTP transport (port 3000)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+/**
+ * Main entry point for the MCP Stock Quotes Server
+ *
+ * This server provides tools for fetching stock quotes from Yahoo Finance
+ * through the Model Context Protocol (MCP).
+ *
+ * Usage:
+ *   node dist/index.js --transport stdio    # Start with stdio transport
+ *   node dist/index.js --transport http     # Start with HTTP transport (port 3000)
+ */
+import { createServer } from './server.js';
+// Parse command line arguments
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {
+        transport: 'stdio',
+        httpPort: 3000,
+        httpHost: '0.0.0.0',
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--transport':
+            case '-t':
+                if (i + 1 < args.length) {
+                    const transport = args[++i].toLowerCase();
+                    if (['stdio', 'http'].includes(transport)) {
+                        result.transport = transport;
+                    }
+                    else {
+                        console.error(`Invalid transport: ${transport}`);
+                        console.error('Valid transports: stdio, http');
+                        process.exit(1);
+                    }
+                }
+                break;
+            case '--http-port':
+            case '--httpPort':
+                if (i + 1 < args.length) {
+                    result.httpPort = Number.parseInt(args[++i], 10);
+                    if (Number.isNaN(result.httpPort) || result.httpPort <= 0 || result.httpPort > 65535) {
+                        console.error('Invalid HTTP port. Port must be between 1 and 65535');
+                        process.exit(1);
+                    }
+                }
+                break;
+            case '--http-host':
+            case '--httpHost':
+                if (i + 1 < args.length) {
+                    result.httpHost = args[++i];
+                }
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+                break;
+            case '--version':
+            case '-v':
+                console.log('StockQuotes.MCP version 1.0.0');
+                process.exit(0);
+        }
+    }
+    return result;
+}
+/**
+ * Print help message
+ */
+function printHelp() {
+    console.log(`
+MCP Stock Quotes Server
+
+Usage: node dist/index.js [options]
+
+Options:
+  --transport, -t <stdio|http>
+    Specify the transport type to use (default: stdio)
+
+  --http-port <port>
+    Specify the HTTP port for HTTP transport (default: 3000)
+
+  --http-host <host>
+    Specify the HTTP host to bind to (default: 0.0.0.0)
+
+  --help, -h
+    Show this help message
+
+  --version, -v
+    Show version information
+
+Examples:
+  # Start with stdio transport (for CLI tools)
+  node dist/index.js --transport stdio
+
+  # Start with HTTP transport on port 8080
+  node dist/index.js --transport http --http-port 8080
+
+  # Start with HTTP transport on localhost
+  node dist/index.js --transport http --http-host localhost
+
+For more information, visit: https://github.com/lionelschiepers/StockQuotes.MCP
+`);
+}
+/**
+ * Main function to start the server
+ */
+async function main() {
+    console.log('MCP Stock Quotes Server');
+    console.log('========================');
+    const args = parseArgs();
+    console.log(`Starting server with ${args.transport} transport...`);
+    try {
+        await createServer({
+            name: 'stock-quotes-server',
+            version: '1.0.0',
+            transport: args.transport,
+            httpPort: args.httpPort,
+            httpHost: args.httpHost,
+        });
+        console.log('Server started successfully');
+        if (args.transport === 'http') {
+            console.log('Press Ctrl+C to stop the server');
+            await new Promise(() => { });
+        }
+    }
+    catch (error) {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    }
+}
+// Handle graceful shutdown
+process.on('SIGINT', () => {
+    console.log('\nShutting down server...');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    console.log('\nShutting down server...');
+    process.exit(0);
+});
+// Start the server
+main().catch((error) => {
+    console.error('Unhandled error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,34 @@
+import type { StockQuotesService } from './stockQuotesService.js';
+import type { ServerConfig } from './types.js';
+/**
+ * MCP Server for Stock Quotes using Yahoo Finance
+ */
+export declare class StockQuotesServer {
+    private config;
+    private stockService;
+    private transportStrategy;
+    /**
+     * Create a new instance of the StockQuotesServer
+     * @param config - Server configuration
+     * @param stockService - Stock quotes service (dependency injected)
+     */
+    constructor(config: ServerConfig, stockService: StockQuotesService);
+    /**
+     * Connect to the appropriate transport using the strategy pattern
+     */
+    connect(): Promise<void>;
+    /**
+     * Get the Express app instance (for testing or custom transport setups)
+     * Only available for HTTP transport
+     */
+    getApp(): unknown;
+    /**
+     * Close the server and cleanup resources
+     */
+    close(): Promise<void>;
+}
+/**
+ * Factory function to create and start the server
+ */
+export declare function createServer(config?: Partial<ServerConfig>): Promise<StockQuotesServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAKlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,iBAAiB,CAAoB;IAE7C;;;;OAIG;gBACS,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB;IAMlE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;;OAGG;IACH,MAAM,IAAI,OAAO;IAQjB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAe7F"}

package/dist/server.js

@@ -0,0 +1,66 @@
+import { StockQuotesService as StockQuotesServiceImpl } from './stockQuotesService.js';
+import { registerToolsOnServer } from './toolRegistration.js';
+import { TransportFactory } from './transports/TransportFactory.js';
+import { YahooFinanceClient } from './yahooFinanceClient.js';
+/**
+ * MCP Server for Stock Quotes using Yahoo Finance
+ */
+export class StockQuotesServer {
+    config;
+    stockService;
+    transportStrategy;
+    /**
+     * Create a new instance of the StockQuotesServer
+     * @param config - Server configuration
+     * @param stockService - Stock quotes service (dependency injected)
+     */
+    constructor(config, stockService) {
+        this.config = config;
+        this.stockService = stockService;
+        this.transportStrategy = TransportFactory.createTransport(config, this.stockService);
+    }
+    /**
+     * Connect to the appropriate transport using the strategy pattern
+     */
+    async connect() {
+        const server = this.transportStrategy.getServer();
+        registerToolsOnServer(server, this.stockService);
+        await this.transportStrategy.connect();
+    }
+    /**
+     * Get the Express app instance (for testing or custom transport setups)
+     * Only available for HTTP transport
+     */
+    getApp() {
+        const strategy = this.transportStrategy;
+        if (typeof strategy.getApp === 'function') {
+            return strategy.getApp();
+        }
+        throw new Error('Express app is only available for HTTP transport');
+    }
+    /**
+     * Close the server and cleanup resources
+     */
+    async close() {
+        await this.transportStrategy.close();
+    }
+}
+/**
+ * Factory function to create and start the server
+ */
+export async function createServer(config) {
+    const serverConfig = {
+        name: 'stock-quotes-server',
+        version: '1.0.0',
+        transport: 'stdio',
+        httpPort: 3000,
+        httpHost: '0.0.0.0',
+        ...config,
+    };
+    const yahooClient = new YahooFinanceClient();
+    const stockService = new StockQuotesServiceImpl(yahooClient);
+    const server = new StockQuotesServer(serverConfig, stockService);
+    await server.connect();
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAe;IACrB,YAAY,CAAqB;IACjC,iBAAiB,CAAoB;IAE7C;;;;OAIG;IACH,YAAY,MAAoB,EAAE,YAAgC;QAChE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;QAClD,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAA0C,CAAC;QACjE,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1C,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;IACvC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA8B;IAC/D,MAAM,YAAY,GAAiB;QACjC,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,OAAO;QAClB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,SAAS;QACnB,GAAG,MAAM;KACV,CAAC;IAEF,MAAM,WAAW,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACjE,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/stockQuotesService.d.ts

@@ -0,0 +1,39 @@
+import type { HistoricalData, StockQuoteInput, StockQuoteResponse, StockSearchResult } from './types.js';
+import type { YahooClient } from './yahooFinanceClient.js';
+/**
+ * Service for fetching stock quotes from Yahoo Finance
+ */
+export declare class StockQuotesService {
+    private readonly yahooClient;
+    /**
+     * Create a new instance of the StockQuotesService
+     */
+    constructor(yahooClient: YahooClient);
+    /**
+     * Fetch a stock quote for the given ticker symbol
+     * @param input - The stock quote input containing the ticker and optional fields
+     * @returns Promise<StockQuoteResponse> - The stock quote data
+     */
+    getQuote(input: StockQuoteInput): Promise<StockQuoteResponse>;
+    /**
+     * Fetch multiple stock quotes at once
+     * @param tickers - Array of ticker symbols
+     * @returns Promise<Map<string, StockQuoteResponse>> - Map of ticker to stock quote data
+     */
+    getMultipleQuotes(tickers: string[]): Promise<Map<string, StockQuoteResponse>>;
+    /**
+     * Search for a company by name or ticker
+     * @param query - Search query string
+     * @returns Promise<Array<{symbol: string, name: string, exchange: string}>> - Search results
+     */
+    search(query: string): Promise<StockSearchResult[]>;
+    /**
+     * Fetches historical stock data for a given ticker, from a start date to an end date.
+     * @param ticker - Stock ticker symbol (e.g., AAPL)
+     * @param fromDate - Start date in 'YYYY-MM-DD' format
+     * @param toDate - End date in 'YYYY-MM-DD' format
+     * @returns Promise<number[]> - An array of closing prices for each day.
+     */
+    getHistoricalData(ticker: string, fromDate: string, toDate: string): Promise<HistoricalData[]>;
+}
+//# sourceMappingURL=stockQuotesService.d.ts.map

package/dist/stockQuotesService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stockQuotesService.d.ts","sourceRoot":"","sources":["../src/stockQuotesService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAIlB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;OAEG;gBACS,WAAW,EAAE,WAAW;IAIpC;;;;OAIG;IACG,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8DnE;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAepF;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA2BzD;;;;;;OAMG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,EAAE,CAAC;CA6B7B"}