Local Stock Analyst MCP (Python)

Python MCP server that exposes stock-analysis tools with:

• Finnhub as primary provider

• Alpha Vantage as fallback

• local fallback calculations for RSI and MACD

• stdio and Render-compatible HTTP transport support

Tools

• get_stock_price

• get_quote

• get_company_profile

• get_candles

• get_stock_news

• get_rsi

• get_macd

• get_key_financials

• get_portfolio

• list_sell_decision_data_requirements

• analyze_portfolio_for_sell

• get_sma

• get_ema

• get_bollinger_bands

• get_atr

• get_adx

• get_stochastic

• get_obv

• get_vwap

• get_support_resistance_levels

• detect_chart_patterns

• get_market_indices

• generate_buy_sell_hold_signal

Requirements

• Python 3.11+

• API key for at least one provider:

  • FINNHUB_API_KEY

  • ALPHAVANTAGE_API_KEY

Setup

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Run Locally

Stdio Mode (Claude Desktop local MCP)

$env:TRANSPORT_MODE="stdio"
python -m mcp_server

HTTP Mode (Render/local web MCP)

$env:TRANSPORT_MODE="http"
$env:HOST="0.0.0.0"
$env:PORT="8000"
python -m mcp_server

Optional HTTP transport mode:

• HTTP_TRANSPORT=sse (default)

• HTTP_TRANSPORT=streamable

Health endpoint defaults to /health.

Claude Desktop (Windows) Configuration

%APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "local-stock-analyst": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "D:/mcpserverdemo/mcplocalstockliveinpythonrender",
      "env": {
        "TRANSPORT_MODE": "stdio",
        "FINNHUB_API_KEY": "YOUR_FINNHUB_KEY",
        "ALPHAVANTAGE_API_KEY": "YOUR_ALPHA_VANTAGE_KEY"
      }
    }
  }
}

Render

Set environment variables:

• TRANSPORT_MODE=auto (or http)

• HOST=0.0.0.0

• PORT provided by Render

• provider API keys

Build command:

pip install -r requirements.txt

Start command:

python -m mcp_server

Tests

python -m pytest -q