convez.ai
MCP ServerFinanceiroIntermediário
a1031198246b

Stock MCP - Dados de Ações Chinesas em Tempo Real

a1031198246b/stock-mcp

Dados de ações chinesas em tempo real com failover e seleção por NL

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que fornece dados de mercado de ações chinesas (A-shares) com múltiplas fontes de dados em tempo real, incluindo cotações, candlesticks, fundamentos e seleção de ações por linguagem natural. Implementa resiliência com failover automático entre fontes (tqcenter, sina, akshare, eastmoney) e oferece 91% de cobertura de testes.

Instalação

$npx convez-ai a1031198246b/stock-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
1
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar cotações em tempo real com profundidade de mercado em aplicações de trading
  • Análise técnica com candlesticks em múltiplas temporalidades (1m a 1M)
  • Consultas em linguagem natural para seleção de ações (iwencai)
  • Monitoramento de fundamentos (PE, PB, ROE, capitalização)
  • Sistemas de agentes IA que precisam de dados financeiros chineses confiáveis

Veredito

MCP server robusto e bem-testado para mercado chinês, com arquitetura de failover inteligente e suporte a seleção de ações por NL. Excelente para aplicações que exigem dados financeiros confiáveis e diversificados, embora requeira setup local (instalação do Tongdaxin) para máxima funcionalidade.

README

A tradução para o português deste README ainda está na fila.

Stock MCP

A 股股票数据 MCP 服务,为 AI Agent 提供实时行情、K 线、基本面、资讯、自然语言选股等能力。

✨ 核心优势(差异化亮点)

特性说明
🔌 tqcenter 主源本地通达信插件,实时行情 + 5档买卖盘(其他项目少见)
🛡️ 多源容错内置熔断、限流、缓存,故障自动切换数据源
🔥 自然语言选股集成 iwencai,支持自然语言问股
✅ 91% 测试覆盖率139 个测试,CI 完整,质量保证
📊 清晰能力矩阵多数据源能力一目了然,按需选用

功能概览

  • 实时行情:tqcenter / sina / akshare 多源自动故障转移
  • K 线:1m/5m/15m/30m/1h/1d/1w/1M
  • 基本面:PE / PB / ROE / 市值 / 行业代码
  • 资讯公告:eastmoney / akshare
  • 自然语言选股:iwencai(需 cookie)

状态

  • P0 脚手架 — 项目结构、配置、日志、MCP server
  • P1 核心数据 — tqcenter 实时行情 + K 线
  • P2 多源 + 韧性 — sina/akshare 适配器、缓存、熔断、限流
  • P3 扩展数据 — tqcenter 基本面(PE/PB/ROE/市值)+ 资讯 + eastmoney
  • P4 高级查询 — iwencai 自然语言选股
  • P5 完善 — 文档、CI、覆盖率(90%)

安装

uv sync --all-extras
cp .env.example .env
# 编辑 .env 设置 TDX_PATH(通达信安装路径)
# 可选: 设置 IWENCAI_COOKIE 启用自然语言选股

运行

uv run stock-mcp

测试

# 单元测试 (mock 适配器, 无外部依赖)
uv run pytest

# 覆盖率
uv run pytest --cov=stock_mcp

# 集成测试 (需本地通达信 + TDX_PATH)
TDX_PATH="C:\new_tdx64" uv run pytest tests/integration/tdxcenter/ -v

接入 Claude Code

在 Claude Code 的 settings.json 中:

{
  "mcpServers": {
    "stock-mcp": {
      "command": "uv",
      "args": ["--directory", "E:/claude codeworkspace/stock-mcp", "run", "stock-mcp"]
    }
  }
}

已实现 MCP 工具

工具说明数据源
ping健康检查—
get_realtime_quote实时行情(含5档买卖盘)tqcenter / sina / akshare
get_klineK线(1m/5m/15m/30m/1h/1d/1w/1M)tqcenter / sina
get_fundamental基本面(PE/PB/ROE/市值/行业代码)tqcenter
get_news资讯公告eastmoney / akshare
query_stocks自然语言选股(需 iwencai cookie)iwencai

数据源能力矩阵

适配器实时行情K线基本面资讯选股
tqcenter (主)✅ 含5档✅ 1d/1w/1M/分钟✅ PE/PB/ROE/市值❌❌
sina (备)✅⚠️ 部分❌❌❌
akshare✅✅✅✅❌
eastmoney❌⚠️ 补全❌✅❌
iwencai (可选)❌❌❌❌✅

数据源

  • tqcenter (priority 1, 主源):通达信插件,需本地安装
  • sina (priority 2):新浪财经 HTTP
  • akshare (priority 3):开源金融数据库
  • eastmoney (priority 4):东方财富,资讯公告
  • iwencai (可选):自然语言选股,需 cookie + Node.js

已知限制

  • tqcenter 基本面 的 industry 字段是 TDX 内部行业代码(字符串数字,如 "37" 表示白酒)。完整的 TDX 行业代码 → 中文名映射是 TDX 私有数据,硬编码容易出错。需要中文行业名时,可查公开的证监会行业分类或 akshare 的 stock_individual_info_em 自行转换。
  • tqcenter PE 是基于最新季报 EPS 算的(不是 TTM),财报发布后会有偏差。需要在交易时间内拉数据。
  • tqcenter 锁状态:TDX 端 PYMP 服务有连接槽位限制。如果反复失败会让 TDX 卡死,需要手动重启 tdxw.exe 解锁。tests/integration/tdxcenter/test_real.py 的 fixture 内部已 3 次重试,不要在 adapter 里再加循环避免锁状态污染。
  • 5档买卖盘 中买一/卖一以外的盘口在非交易活跃时段常常为 0,这是真实数据(流动性低),不是 bug。
Ver o original no GitHub

Bom para

Relacionados