pip install -r requirements.txt

cp .env.example .env
# Edit .env with your API keys

python finance_data_server.py

{
  "mcpServers": {
    "finance-data": {
      "command": "python",
      "args": ["/path/to/finance-data-mcp/finance_data_server.py"],
      "env": {}
    }
  }
}

finance_data_server.py          # MCP Server entry point + MarketRouter
├── datasources/
│   ├── alpha_vantage_adapter.py  # US/ETF stocks (Alpha Vantage API)
│   ├── akshare_adapter.py        # A-share / HK stocks (AKShare + East Money)
│   ├── tushare_adapter.py        # A-share stocks (Tushare Pro API)
│   └── yfinance_adapter.py       # All markets fallback (Yahoo Finance)
├── alpha_vantage_client.py       # Alpha Vantage HTTP client
└── alpha_vantage_rate_limiter.py # Per-key rate limiting with persistence

MCP Client Request
       │
       ▼
  MarketRouter (routes by market type)
       │
       ├─ US/ETF ──→ AlphaVantage → yfinance
       ├─ A-share ──→ Tushare → AKShare → yfinance
       └─ HK ──────→ AKShare → yfinance

{
  "symbol": "AAPL",
  "market": "US",
  "price": 185.50,
  "change": 2.30,
  "change_pct": 1.25,
  "volume": 52340000,
  "high": 186.20,
  "low": 183.10,
  "open": 183.80,
  "previous_close": 183.20,
  "currency": "USD",
  "source": "alpha_vantage"
}

{
  "symbol": "AAPL",
  "market": "US",
  "report_type": "income_statement",
  "period": "annual",
  "data": [
    {
      "period": "2024-09-30",
      "revenue": 391035000000,
      "net_income": 93736000000,
      "eps_basic": 6.11
    }
  ],
  "count": 5,
  "source": "alpha_vantage"
}