factorhub-mcp 0.1.0

MCP server for FactorHub — China A-share market data for AI agents

FactorHub MCP Server

China A-share market data for AI agents. Query factor scores, market quotes, valuations, and run strategy backtests — all through the Model Context Protocol (MCP).

Features

Tool	Description
list_factors	因子列表（分类、搜索）
get_factor_scores	因子评分指标（年化收益、夏普、IC等）
get_factor_nav	因子净值曲线
get_market_daily	个股日线行情（OHLCV）
get_index_daily	指数日线（上证、沪深300等）
get_valuation	估值指标（PE、PB、PS、股息率）
get_stock_info	个股基本信息
get_stock_list	股票筛选
get_trade_dates	交易日历
run_backtest	量化策略回测

Quick Start

1. Get an API Key

Sign up at factorhub.cn and generate your API key at the API Keys page. Free tier includes 10 API calls/day.

2. Install

pip install factorhub-mcp

Or install from source:

git clone https://github.com/michaelfeng/factorhub-mcp.git
cd factorhub-mcp
pip install -e .

3. Configure

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "factorhub": {
      "command": "factorhub-mcp",
      "env": {
        "FACTORHUB_API_KEY": "fh_your_api_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "factorhub": {
      "command": "factorhub-mcp",
      "env": {
        "FACTORHUB_API_KEY": "fh_your_api_key_here"
      }
    }
  }
}

OpenClaw

Copy openclaw/factorhub-skill.yaml to your OpenClaw skills directory, or add the MCP config directly:

providers:
  factorhub:
    type: mcp
    command: factorhub-mcp
    env:
      FACTORHUB_API_KEY: "fh_your_api_key_here"

Smithery

Install via Smithery for automatic setup.

Usage Examples

Once configured, ask your AI assistant:

• "查看 FactorHub 有哪些因子"
• "获取 ROE 因子的历史表现"
• "帮我查一下贵州茅台最近一年的行情"
• "用低估值策略回测沪深300成分股"
• "对比动量因子和价值因子的夏普比率"

Pricing

Plan	API Calls/Day	Backtest/Day	Price
Free	10	1	¥0
Starter	50	5	¥39/mo
Pro	200	20	¥99/mo
Enterprise	1000	100	¥299/mo

Upgrade at factorhub.cn/pricing.

Architecture

This MCP server is a thin client that calls the FactorHub public API. It does not access any database directly or contain proprietary logic.

AI Agent  →  MCP Protocol  →  factorhub-mcp  →  HTTPS  →  factorhub.cn/api/v1

Security

• API key is stored in environment variables, never hardcoded
• All communication uses HTTPS
• No user data is stored locally
• Rate limiting is enforced server-side

License

MIT