MCP Stocks Analyzer

A simple and efficient Model Context Protocol (MCP) server for financial analysis. This tool provides real-time stock data and news aggregation for AI assistants.

---

Features

• News: Fetch stock news from Google News.
• Prices: Get historical OHLCV data from Yahoo Finance.
• Company info: Read fundamentals and profile data.
• Technical indicators: Compute trend, momentum, volatility, and volume signals.
• MCP-ready: Designed to plug into AI assistants.

---

Installation

1. Clone the repository:

   git clone https://github.com/vashishtavarma/mcp-stocks-analyzer.git
   cd mcp-stocks-analyzer
   

2. Create and activate a virtual environment:

   python -m venv venv
   # On Windows:
   venv\Scripts\activate
   # On macOS/Linux:
   source venv/bin/activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

---

Usage

1. Start the MCP server:

   python main.py
   

2. Use the available tools from your MCP client:

   • get_news_from_google(ticker, region='IN', period='7d')
   • get_stock_price(symbol, period, interval)
   • get_company_info(symbol)
   • get_technical_indicators(symbol, period='6mo', interval='1d')

---

Project Structure

• main.py: MCP server entry point that registers tools.
• src/news.py: News fetching tool.
• src/price.py: Price history tool.
• src/company.py: Company info tool.
• src/indicators.py: Technical indicators tool.

---

Claude Desktop Setup

To integrate MCP Stocks Analyzer with Claude Desktop, follow these steps:

1. Locate the Configuration File:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the Server Configuration: Insert the following JSON snippet into the mcpServers object in the configuration file:

   {
     "mcpServers": {
       "stock-analyzer": {
         "command": "<path>/mcp-stocks-analyzer/venv/bin/python",
         "args": [
           "<path>/mcp-stocks-analyzer/main.py"
         ]
       }
     }
   }
   

   Note for Windows users: Adjust the python path to ...\\venv\\Scripts\\python.exe and use backslashes.

   Important: Replace <path> with the absolute path to your project directory.

3. Restart Claude Desktop: Restart the application to apply the changes. The MCP Stocks Analyzer tools will now be available in Claude Desktop.

---

License

This project is licensed under the MIT License. See the LICENSE file for details.