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