mh-fin-mcp

中文文档

MCP Server for China A-Share quantitative market data, powered by MetricHub Quant.

Features

• Market Overview: Major indices, limit-up/down stats, breadth, northbound flow, sentiment
• Industry Rotation: Shenwan industry ranking with up/down ratio and limit-up counts
• Sector Hotspots: Concept sector analysis with leading stocks
• Stock Data: Full daily data for 5000+ A-shares (OHLCV, PE, PB, market cap, money flow)
• Stock Search: Search by name or code
• Limit-Up Analysis: 13-factor quantitative scoring for limit-up stocks
• Factor IC: Factor effectiveness history
• Risk Alerts: Shareholder reduction, performance warnings

Quick Start

1. Get API Key

Register at quant.metrichub.app, then go to API Key management to create a key.

2. Choose your integration method

Option A: Remote Server (Recommended, zero install)

No installation needed. Just add the URL to your config:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mh-fin": {
      "url": "https://api.quant.metrichub.app/mcp/sse",
      "headers": {
        "X-API-Key": "mhfk_your_key_here"
      }
    }
  }
}

Claude Code (.claude/settings.json):

{
  "mcpServers": {
    "mh-fin": {
      "url": "https://api.quant.metrichub.app/mcp/sse",
      "headers": {
        "X-API-Key": "mhfk_your_key_here"
      }
    }
  }
}

Option B: Local Install (via PyPI)

pip install mh-fin-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mh-fin": {
      "command": "uvx",
      "args": ["mh-fin-mcp"],
      "env": {
        "MH_FIN_API_KEY": "mhfk_your_key_here"
      }
    }
  }
}

Claude Code (.claude/settings.json):

{
  "mcpServers": {
    "mh-fin": {
      "command": "uvx",
      "args": ["mh-fin-mcp"],
      "env": {
        "MH_FIN_API_KEY": "mhfk_your_key_here"
      }
    }
  }
}

3. Restart Claude to activate

Available Tools

| Tool | Description | |------|-------------| | get_trade_dates | List available trade dates | | get_market_overview | Market overview: indices, breadth, sentiment, northbound flow | | get_industry_ranking | Industry rotation ranking (Shenwan industries) | | get_sector_hotspots | Concept sector hotspots with leading stocks | | get_stock_list | Paginated stock data for 5000+ A-shares | | search_stock | Search stocks by name or code | | get_limitup_analysis | Limit-up analysis with 13 quantitative factors | | get_factor_ic | Factor IC effectiveness history | | get_risk_alerts | Risk alerts (shareholder reduction, etc.) |

Data

• Covers all 5000+ A-shares
• Updated daily after 17:30 CST (Mon-Fri)
• 13 quantitative factors for limit-up scoring
• Data only, no investment advice

License

MIT