{
  "markdown": "# mh-fin-mcp\n\n<!-- mcp-name: io.github.clk1st/mh-fin-mcp -->\n\n[中文文档](./README_CN.md)\n\nMCP Server for China A-Share quantitative market data, powered by [MetricHub Quant](https://quant.metrichub.app).\n\n## Features\n\n- **Market Overview**: Major indices, limit-up/down stats, breadth, northbound flow, sentiment\n- **Industry Rotation**: Shenwan industry ranking with up/down ratio and limit-up counts\n- **Sector Hotspots**: Concept sector analysis with leading stocks\n- **Stock Data**: Full daily data for 5000+ A-shares (OHLCV, PE, PB, market cap, money flow)\n- **Stock Search**: Search by name or code\n- **Limit-Up Analysis**: 13-factor quantitative scoring for limit-up stocks\n- **Factor IC**: Factor effectiveness history\n- **Risk Alerts**: Shareholder reduction, performance warnings\n\n## Quick Start\n\n### 1. Get API Key\n\nRegister at [quant.metrichub.app](https://quant.metrichub.app), then go to [API Key management](https://quant.metrichub.app/api-keys) to create a key.\n\n### 2. Choose your integration method\n\n#### Option A: Remote Server (Recommended, zero install)\n\nNo installation needed. Just add the URL to your config:\n\n**Claude Desktop** (`claude_desktop_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"mh-fin\": {\n      \"url\": \"https://api.quant.metrichub.app/mcp/sse\",\n      \"headers\": {\n        \"X-API-Key\": \"mhfk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code** (`.claude/settings.json`):\n```json\n{\n  \"mcpServers\": {\n    \"mh-fin\": {\n      \"url\": \"https://api.quant.metrichub.app/mcp/sse\",\n      \"headers\": {\n        \"X-API-Key\": \"mhfk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Option B: Local Install (via PyPI)\n\n```bash\npip install mh-fin-mcp\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"mh-fin\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mh-fin-mcp\"],\n      \"env\": {\n        \"MH_FIN_API_KEY\": \"mhfk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code** (`.claude/settings.json`):\n```json\n{\n  \"mcpServers\": {\n    \"mh-fin\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mh-fin-mcp\"],\n      \"env\": {\n        \"MH_FIN_API_KEY\": \"mhfk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart Claude to activate\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_trade_dates` | List available trade dates |\n| `get_market_overview` | Market overview: indices, breadth, sentiment, northbound flow |\n| `get_industry_ranking` | Industry rotation ranking (Shenwan industries) |\n| `get_sector_hotspots` | Concept sector hotspots with leading stocks |\n| `get_stock_list` | Paginated stock data for 5000+ A-shares |\n| `search_stock` | Search stocks by name or code |\n| `get_limitup_analysis` | Limit-up analysis with 13 quantitative factors |\n| `get_factor_ic` | Factor IC effectiveness history |\n| `get_risk_alerts` | Risk alerts (shareholder reduction, etc.) |\n\n## Data\n\n- Covers all 5000+ A-shares\n- Updated daily after 17:30 CST (Mon-Fri)\n- 13 quantitative factors for limit-up scoring\n- Data only, no investment advice\n\n## License\n\nMIT\n",
  "bytes": 3015,
  "sha": "bc69bf5036f2194056c755b1ed72397fcbd41a7355a064579b74e52b0da82089",
  "repo_slug": "clk1st/mh-fin-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_clk1st_mh_fin_mcp_cc987fab/readme"
}