Financial Information MCP

基于东方财富 + 天天基金的查询型 MCP 服务（MVP+）。

功能

• get_stock_detail: 根据股票代码查询量化详情
• get_fund_detail: 根据基金代码查询量化详情
• batch_get_details: 批量查询股票/基金详情（支持并发）
• get_historical_series: 查询股票/基金历史序列
• get_provider_health: 查询上游 provider 健康统计

数据源

• 东方财富搜索: searchapi.eastmoney.com
• 东方财富股票行情: push2.eastmoney.com (含多域降级)
• 东方财富股票历史: push2his.eastmoney.com
• 东方财富基金数据: fundmobapi.eastmoney.com
• 天天基金估值: fundgz.1234567.com.cn
• 天天基金扩展数据: fund.eastmoney.com/pingzhongdata

运行

npm install
npm run start

验证

npm run lint
npm test
npm run e2e:mcp

可选环境变量（并发/限流）

• HTTP_MAX_CONCURRENCY: 上游 HTTP 最大并发（默认 6）
• HTTP_MIN_INTERVAL_MS: 上游请求最小间隔毫秒（默认 80）

工具入参

get_stock_detail

{
  "code": "600519"
}

get_fund_detail

{
  "code": "161725"
}

batch_get_details

{
  "items": [
    { "code": "600519", "asset_type": "stock" },
    { "code": "161725", "asset_type": "fund" },
    { "code": "000858" }
  ],
  "continue_on_error": true,
  "concurrency": 4
}

get_historical_series

{
  "code": "600519",
  "asset_type": "stock",
  "period": "3m",
  "granularity": "weekly",
  "limit": 120
}

基金历史查询示例：

{
  "code": "161725",
  "asset_type": "fund",
  "period": "1y",
  "granularity": "quarterly",
  "limit": 200
}

get_provider_health

{
  "include_recent_events": true,
  "event_limit": 50,
  "window_limit": 200
}

返回特点

• 字段以数值型为主，便于量化系统直接消费
• 含 units 字段标注单位
• 含 cache_hit 字段指示缓存命中
• 含 meta 字段用于观测（request_id、duration_ms 等）
• 错误返回统一结构：{ ok: false, error: { code, message, details } }

长时程任务文档入口（Docs Control Panel）

• 任务规格：docs/spec.md
• 里程碑计划：docs/plans.md
• Codex 执行手册：docs/implement.md
• 共享记忆与审计日志：docs/documentation.md
• 架构说明：docs/architecture.md
• Schema 版本治理：docs/schema-versioning.md
• 发布说明：docs/releases/v0.5.0.md
• 客户端接入示例：docs/client-integration.md
• 可复用模板：docs/templates/

注意事项

• 东方财富非官方公开接口可能偶发空响应，已实现重试与降级。
• 批量查询若为生产场景，建议显式传 asset_type，避免自动识别歧义。
• 股票历史查询若上游 K 线不可用，会回退到实时快照单点数据（fallback_used=true）。
• 当前不包含交易能力。