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