io.github.clk1st/mh-fin-mcp

Official

by clk1st · Python

MetricHub Quant - A股量化数据

China A-Share quantitative data: 5000+ stocks, 13 factors, daily market & limit-up analysis.

Provides quantitative stock data and market analysis for 5000+ Chinese A-Share stocks.

README.md3 KBView on GitHub

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

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):

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):

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)

bash

pip install mh-fin-mcp

Claude Desktop (claude_desktop_config.json):

json

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

Claude Code (.claude/settings.json):

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

Install

Configuration

Environment variables

MH_FIN_API_KEYrequiredsecret

API key from https://quant.metrichub.app/api-keys

claude_desktop_config.json

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