📈 Stock Market Real-Time Analyzer

A comprehensive Python tool for fetching and analyzing real-time stock market data from multiple public APIs. Features include a command-line interface, web dashboards, and an MCP (Model Context Protocol) server for AI assistant integration.

✨ Features

• Multi-Source Data Fetching: Get stock data from Yahoo Finance, Alpha Vantage, and Finnhub

• Real-Time Analysis: Compare prices across different sources

• Multiple Interfaces:

  • Command-line tool

  • Web dashboard (Flask)

  • Standalone HTML dashboard

  • Streamlit dashboard

  • MCP server for AI assistants (Claude, Kiro)

• Comprehensive Data: Price, change, volume, market cap, day high/low, and more

• Easy Integration: Works with Claude Desktop and other MCP-compatible clients

🚀 Quick Start

Installation

Basic Usage

Command Line:

Standalone Dashboard:

Web Dashboard:

🔑 API Keys (Optional)

Yahoo Finance works without API keys. For additional sources:

1. Copy .env.example to .env

2. Add your API keys:

   • Alpha Vantage - Free tier: 25 requests/day

   • Finnhub - Free tier available

🤖 MCP Server Integration

Use this tool with AI assistants like Claude Desktop or Kiro.

Setup for Claude Desktop

1. Run the setup script:

2. Restart Claude Desktop

3. Ask Claude: "Get the stock price for AAPL"

See CLAUDE_DESKTOP_SETUP.md for detailed instructions.

Setup for Kiro

The MCP server is pre-configured in .kiro/settings/mcp.json. Just restart Kiro and ask:

• "Get the stock price for AAPL"

• "Compare TSLA across all sources"

📊 Available Tools

Command Line

MCP Server Tools

When integrated with AI assistants, you get access to:

1. get_stock_quote - Get quote from specific sources

2. compare_stock_sources - Compare data across all sources

3. get_best_quote - Get most reliable quote

4. get_multiple_quotes - Get quotes for multiple symbols

🏗️ Project Structure

📖 Documentation

• MCP Setup Guide - Detailed MCP server configuration

• Claude Desktop Setup - Claude Desktop integration

• Workflow Diagram - Complete data flow explanation

• Quick Start Guide - Getting started quickly

🔧 Requirements

• Python 3.9+

• Internet connection for API access

• Optional: API keys for Alpha Vantage and Finnhub

📦 Dependencies

• requests - HTTP requests

• pandas - Data manipulation

• yfinance - Yahoo Finance API

• python-dotenv - Environment variables

• flask - Web dashboard (optional)

• streamlit - Streamlit dashboard (optional)

• mcp - Model Context Protocol server

🎯 Use Cases

• Real-time stock monitoring - Track multiple stocks simultaneously

• Price comparison - Verify prices across different data sources

• AI assistant integration - Ask AI for stock data in natural language

• Data analysis - Export data for further analysis

• Portfolio tracking - Monitor your investments

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs

• Suggest new features

• Submit pull requests

• Improve documentation

📝 License

MIT License - feel free to use this project for personal or commercial purposes.

🙏 Acknowledgments

• Yahoo Finance - Primary data source

• Alpha Vantage - Financial data API

• Finnhub - Stock market data

• Model Context Protocol - AI integration standard

📧 Contact

For questions or support, please open an issue on GitHub.

⚠️ Disclaimer

This tool is for informational purposes only. Stock market data may be delayed. Always verify information before making investment decisions. Not financial advice.

Made with ❤️ for stock market enthusiasts and AI developers