MCP Server 接入指南

将 A 股量化数据接入 Claude Desktop、Claude Code 等 AI 工具

1. 获取 API Key

2. 选择接入方式

三种方式任选其一。推荐优先使用 方式 A（兼容性最好），对客户端支持有疑问时回退到 方式 B（本地运行最稳定）。

方式 A：通过 mcp-remote 代理（推荐，兼容所有主流客户端）

mcp-remote 把远程 SSE 服务转成本地 stdio，解决了 Claude Desktop / Cursor 等客户端对远程 MCP + 自定义 header 支持不一致的问题。需要本机有 Node.js。

配置（claude_desktop_config.json 或 .claude/settings.json）：

{
  "mcpServers": {
    "mh-fin": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.quant.metrichub.app/mcp/sse",
        "--header",
        "X-API-Key:mhfk_你的密钥"
      ]
    }
  }
}

方式 B：本地安装 PyPI 包（最稳定，全本地 stdio）

完全不依赖长连接，网络抖动不会断开。需要本机有 Python（推荐用 uvx，无需手动 pip install）。

配置（claude_desktop_config.json 或 .claude/settings.json）：

{
  "mcpServers": {
    "mh-fin": {
      "command": "uvx",
      "args": ["mh-fin-mcp"],
      "env": {
        "MH_FIN_API_KEY": "mhfk_你的密钥"
      }
    }
  }
}

方式 C：客户端原生远程连接（仅部分客户端支持）

不需要本机装任何东西，直接让客户端连远程 SSE。但不少客户端（如部分版本的 Claude Desktop）对自定义 header 或长连接保活处理不完善，可能出现 ECONNRESET。遇到问题请切换到方式 A 或 B。

{
  "mcpServers": {
    "mh-fin": {
      "url": "https://api.quant.metrichub.app/mcp/sse",
      "headers": {
        "X-API-Key": "mhfk_你的密钥"
      }
    }
  }
}

3. 重启 Claude 即可使用

配置完成后重启 Claude Desktop 或 Claude Code，在对话中直接提问即可：

"今天 A 股市场整体表现如何？"
"帮我查一下最近涨停的股票"
"搜索一下贵州茅台的数据"
"最近哪些行业表现最强？"
"有哪些风险预警的股票？"

可用工具

工具	说明
get_trade_dates	获取可用交易日列表
get_market_overview	市场全景：指数、涨跌停、北向资金、情绪评分
get_industry_ranking	行业轮动排名
get_sector_hotspots	板块热点统计
get_stock_list	全市场个股数据（5000+ 只，支持排序分页）
search_stock	按名称或代码搜索个股
get_limitup_analysis	涨停分析：13 因子量化评分
get_factor_ic	因子 IC 有效性历史
get_risk_alerts	风险预警：股东减持(R1)、业绩预亏(R2)

PyPI: mh-fin-mcp · GitHub: clk1st/mh-fin-mcp