MCP 服务器

Stock Analysis MCP Server

Provides financial stock analysis for U.S. public companies via SEC EDGAR APIs, offering tools to resolve companies, retrieve filings, calculate profitability metrics, compare periods, detect red flags, and get audit evidence, all without API keys.

README

Multi-Market Stock Analysis MCP Server 📈🌍

A defensible, filing-based Model Context Protocol (MCP) server for financial stock analysis supporting US (SEC EDGAR), Egypt (EGX/FRA), Dubai (DFM), and Abu Dhabi (ADX) markets.

🏛️ Regional Market Adapters

Adapter Module	Supported Exchanges / Markets	Key Responsibilities
`twelve_data_adapter`	EGX, DFM, ADX, US Equities	Market quotes, symbol resolution, and exchange metadata
`sec_edgar_adapter`	SEC EDGAR (USA)	Official US 10-K/10-Q filing history and XBRL fact extraction
`egx_disclosures_adapter`	EGX / FRA (Egypt)	Egyptian Exchange announcements and financial statements (`COMI`, `HRHO`, `ETEL`)
`dfm_disclosures_adapter`	DFM (Dubai, UAE)	Dubai Financial Market disclosures and quarterly releases (`EMAAR`, `DIB`, `DEWA`)
`adx_reports_adapter`	ADX (Abu Dhabi, UAE)	Abu Dhabi Securities Exchange reports and releases (`EAND`, `FAB`, `IHC`)
`regional_analysis_engine`	Universal Multi-Currency (`EGP`, `AED`, `USD`)	Deterministic metric calculations and red-flag diagnostics

🛠️ Unified MCP Tools

Tool	Description	Key Arguments
`resolve_company`	Resolve symbol, CIK, or name across US, EGX, DFM, and ADX	`query`, `market`
`list_disclosures`	List recent disclosures, filing announcements, and regulatory releases	`ticker_or_symbol`, `market`, `limit`
`get_financial_report`	Return financial report metadata, summary, and direct document source links	`ticker_or_symbol`, `market`, `period`
`extract_statement`	Extract structured financial statement facts (Income, Balance, Cash Flow)	`ticker_or_symbol`, `statement_type`, `market`
`calculate_profitability`	Compute Net Income, Free Cash Flow (`Operating Cash Flow - CapEx`), Margins, EBITDA Proxy, SBC	`ticker_or_symbol`, `market`, `period_type`
`compare_periods`	Multi-period financial comparisons and YoY growth rates	`ticker_or_symbol`, `metric`, `market`, `num_periods`
`detect_red_flags`	Apply financial red-flag diagnostic tests (cash conversion, margin compression, receivables lag)	`ticker_or_symbol`, `market`
`get_evidence`	Return audit evidence, accession numbers/source IDs, filing URLs, and calculation traces	`ticker_or_symbol`, `fact_tag`, `market`

🚀 Quick Start (Docker)

# Build Docker image
docker build -t stock-analysis-mcp-server:latest .

# Run container interactively
docker run -i --rm stock-analysis-mcp-server:latest

💻 Configuration (`mcp_config.json`)

{
  "mcpServers": {
    "stock_analysis": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "stock-analysis-mcp-server:latest"
      ]
    }
  }
}