mcp-markets 0.13.1

English | 简体中文

⚡ Quick Start

pip install mcp-markets

# Mode 1: Run as an MCP Server (for Claude / Codex / Cursor)
python -m mcp_finance.server

# Mode 2: Launch the built-in Web Dashboard
mcp-dashboard              # default http://localhost:8080

Python 3.10+ · MCP Python SDK 2.x · Zero config · Optional TUSHARE_TOKEN env var for advanced fundamentals

✨ Capabilities at a Glance

🏗️ Four-Source Architecture

graph LR
    A["📡 Data Sources"] --> B["⚡ easy-tdx<br/>TDX TCP · <50ms"]
    A --> C["🌐 AKShare<br/>Sina / THS / EastMoney"]
    A --> D["🌍 yfinance<br/>Yahoo Finance Fallback"]
    A --> E["📈 Tushare<br/>Deep Fundamentals · Token"]

    B --> F["🔧 31 MCP Tools"]
    C --> F
    D --> F
    E --> F

    F --> G["📈 Quotes<br/>Real-time · Batch · K-line"]
    F --> H["🔬 Technical<br/>MA·MACD·KDJ·RSI·BOLL"]
    F --> I["📋 Screening<br/>Conditional · 5-Factor"]
    F --> J["⚙️ Backtest<br/>9 Strategies · Bayesian Opt"]
    F --> K["📊 Portfolio<br/>Comparison · Correlation"]
    F --> L["🏢 Fundamentals<br/>Financials · Research · Flow"]
    F --> M["🖥️ Dashboard<br/>Flask Web · Live Refresh"]

    style A fill:#1e1b4b,stroke:#6366f1,color:#fff
    style F fill:#0f172a,stroke:#334155,color:#fff
    style G fill:#312e81,color:#fff
    style H fill:#312e81,color:#fff
    style I fill:#312e81,color:#fff
    style J fill:#312e81,color:#fff
    style K fill:#312e81,color:#fff
    style L fill:#312e81,color:#fff
    style M fill:#be185d,color:#fff

🎯 All 31 MCP Tools

Quotes & Market Data

Technical Analysis

Screening & Analysis

Backtesting & Optimization

Market Intelligence

Fundamentals

🖥️ Web Dashboard

Built-in Flask dashboard that visualizes all MCP tool capabilities.

mcp-dashboard              # http://localhost:8080
mcp-dashboard 3000         # custom port
mcp-dashboard --host 0.0.0.0  # explicitly allow LAN access

Responsive layout · Plotly / ECharts interactive charts · Live quote refresh

🔌 MCP Client Setup

{
  "mcpServers": {
    "mcp-finance": {
      "command": "python",
      "args": ["-m", "mcp_finance.server"]
    }
  }
}

codex mcp add mcp-finance -- python -m mcp_finance.server

{
  "mcpServers": {
    "mcp-finance": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_finance.server"]
    }
  }
}

Optional: Tushare fundamentals — Set TUSHARE_TOKEN=your_token env var. Register free. Falls back gracefully without it.

🧪 Development & Testing

git clone https://github.com/ojkkk/mcp-finance.git
cd mcp-finance
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Lint
ruff check mcp_finance/

🌟 AI Conversation Examples

⚠️ Disclaimer

This tool is for educational purposes only. All data is for reference and does not constitute investment advice.

• Data is sourced from third-party public APIs and web scraping, with no guarantee of accuracy, completeness, or timeliness
• No proprietary data sources; all data depends on easy-tdx (reverse-engineered TDX protocol), AKShare (web scraping), yfinance, and Tushare
• No commercial data license; personal non-commercial use is acceptable, commercial use carries copyright and compliance risks
• Backtest results do not predict future performance
• The author bears no responsibility for any investment losses · Invest at your own risk

📄 License

MIT © mcp-finance