TDX Finance MCP Plugin v3
简介
TDX Finance MCP Plugin v3 是一个为 OpenClaw 平台设计的金融数据服务插件,提供通达信(TDX)A 股金融数据接口的统一访问能力。
本插件封装了 8 个经过验证的核心工具(6 个联网数据工具 + 2 个本地固化清单工具),并内置 48 个专业投资分析技能,覆盖 A 股实时行情、K线、F10 基本面、智能选股、指标筛选、代码检索、主要指数与行业板块目录等需求。
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
TDX Finance MCP Plugin v3 是一个为 OpenClaw 平台设计的金融数据服务插件,提供通达信(TDX)A 股金融数据接口的统一访问能力。
本插件封装了 8 个经过验证的核心工具(6 个联网数据工具 + 2 个本地固化清单工具),并内置 48 个专业投资分析技能,覆盖 A 股实时行情、K线、F10 基本面、智能选股、指标筛选、代码检索、主要指数与行业板块目录等需求。
通达信(TDX)A股金融数据 MCP 插件-v3— 6 个核心工具(实时行情/K线/F10基本面/智能选股/指标/代码检索)+ 45 个投资分析技能,适配 OpenClaw,经真实接口实测。
v3 是在 v2 基础上的清理与精简版本,主要变更(详见 CHANGELOG.md):
401 need login 的失效工具(wenda_news_query / wenda_report_query / wenda_notice_query / wenda_macro_query)。这些功能已在技能层迁移至 F10 模块,旧工具不再需要。tdx_quotes / tdx_kline 数字传参崩溃(LLM 客户端把 code/setcode 传成 number 时 String() 规范化兜底)。tdx_index_list(100 个主要指数固化清单)与 tdx_industry_list(503 个行业板块目录,一级 30 / 二级 128 / 三级 345)两个本地固化清单工具,工具总数 6 → 8;移植 tdx-yijinerb-daban(一进二打板,含云端通道)与 tdx-obv-ma-strategy(OBV+MA 量价共振)技能,技能总数 46 → 48。tdx-intraday-tracking),技能总数 45 → 46;配套 scripts/indicators.mjs(MA/MACD/KDJ/OBV 海峡四象限,真实日K验证)。tdx-daban-yijinerb-PS-SKILL),技能总数 46 → 45。tdx_api_data 注册表接入 ybpj|yjyg(业绩预告,服务端当前返回空表、原始透传);修复 tdx_quotes 摘要涨跌幅 NaN;修正测试分类器对数据数字的 401 误判(详见 CHANGELOG.md)。现在工具层、清单(
openclaw.plugin.json)与文档三者完全一致:8 个工具,全部可用。
tdx-finance-mcp-plugin-v3/
├── index.js # 8 个数据工具(核心实现,单文件 ESM)
├── openclaw.plugin.json # 插件清单(工具 + 技能声明)
├── skills/ # 48 个专业投资技能(提示词 + agents 配置)
├── install.sh # Linux/Mac 安装脚本
├── install.ps1 # Windows 安装脚本
├── config.example.json # 配置示例
├── SKILLS.md # 技能清单与触发词
├── CHANGELOG.md # 版本变更记录
└── README.md # 本文件
本插件的 6 个联网工具调用 2 个不同的 API 服务器;另有 2 个固化清单工具(tdx_index_list / tdx_industry_list)数据内置插件、本地直返,不发起网络请求。理解这一架构是正确使用和调试的关键。
⚠️ 重要:不同工具使用不同的 Entry 名称和请求体格式(见 工具文档)。不要根据工具名猜测 Entry 名称。
🟢 = 完全可用。F10 个别子模块服务端未注册(
E|-7202),与 Token 权限无关(详见下方实测结果)。
通过
test/run-tests.mjs驱动真实插件代码实测。完整报告见 test/test-report.md。
gsgk、公司概要 zxts/gsgy、盈利预测 ybpj/yzyq、业绩预告 ybpj/yjyg(服务端当前返回空表,原始透传)、事件与题材 rdtc/sjcd·zttzbkz·zttzztk、龙虎榜涨停/大宗/融资融券/资金流 jyds/ztfx·dzjy·rzrq·zjlx、股东研究 gdyj/gdrs·cgbd·jgcg·jgcgqk·ltgd、股本结构 gbjg/xslt、主力持仓 zlcc、分红 fhrz/fhpm_pxrzb·pxmz、综合 comreq/jglhb。fhrz_fh/fh、异动 iyds/yxsbxx(E|-7202 / HTTP 503)。另有 4 个非标准 fixedTag 组合返回 -1005 数据库执行失败(探测噪声,不代表 entry 不可达)。401 需登录 子模块(股东人数/分红历史/融资融券/资金流向等)为测试分类器把数据数字(如 4.814011、4018)误判为 401 的伪影,v3.3.0 已修复分类器——上述子模块实际全部可用,无需升级 Token 权限。tdx-obv-ma-strategy 与 tdx-yijinerb-daban 依赖本地通道/云端 Python 脚本,测试框架标注「无可测依赖」单列)。测试框架(test/run-tests.mjs)动态枚举 skills/ 目录,按各技能声明的数据依赖逐项验证;「部分可用」指个别依赖子模块未注册时自动降级。git clone https://github.com/adambbhe/TDX-finance-mcp-plugin-v3.git
cd TDX-finance-mcp-plugin-v3
# 一键安装(自动配置 Token + 安装 48 个技能)
# Linux/Mac:
chmod +x install.sh && ./install.sh
# Windows:
.\install.ps1 -Token "你的TDX_API_TOKEN"
复制 config.example.json 为 config.json 并填入你的 Token(config.json 已被 .gitignore 忽略,不会误提交):
{
"plugins": {
"tdx-finance-mcp": {
"enabled": true,
"config": { "tdxApiToken": "你的通达信API_TOKEN" }
}
}
}
或使用环境变量:
# Linux/Mac
export TDX_API_KEY="你的API_KEY"
# Windows PowerShell
$env:TDX_API_KEY = "你的API_KEY"
openclaw start
插件会自动加载 8 个工具 + 48 个技能。
tdxApiToken(必填)通达信 API 授权令牌。插件将其作为 HTTP header token: <tdx-api-token> 发送。
Token 注入优先级:
tdxApiToken 字段TDX_API_KEY(回退方案)apiEndpoint(可选)仅对服务器1的工具生效。默认 http://tdxhub.icfqs.com:7615/TQLEX。
优先级:参数 apiEndpoint → 配置 apiEndpoint → TDX_API_DATA_ENDPOINT → TDX_API_ENDPOINT → 硬编码默认值。
⚠️ 每个工具的 Entry 名称、请求体格式和目标服务器都不同。以下信息均从源码
index.js提取验证。
tdx_api_data — F10 基本面数据统一接口http://tdxhub.icfqs.com:7615/TQLEXTdxSharePCCW. 等为前缀{ Params: [...] }// 盈利预测
{ "entry": "TdxSharePCCW.tdxf10_gg_ybpj", "code": "000001", "fixedTag": "yzyq" }
// 业绩预告(服务端当前返回空表,原始透传)
{ "entry": "TdxSharePCCW.tdxf10_gg_ybpj", "code": "000001", "fixedTag": "yjyg" }
// 热点题材板块族谱
{ "entry": "TdxSharePCCW.tdxf10_gg_rdtc", "code": "000001", "fixedTag": "zttzbkz" }
// 事件驱动催化
{ "entry": "TdxSharePCCW.tdxf10_gg_rdtc", "code": "000001", "fixedTag": "sjcd" }
工具支持多种参数模板(raw / code-only / code-fixed-tag / fixed-tag-code-extra / code-date-range-page 等),可按 entry + fixedTag 自动推导。详见源码与各技能的 SKILL.md。
tdx_quotes — 实时行情查询TdxShare.PBHQInfo · 请求体:结构化对象tdx_quotes code="000001" setcode="0" # 平安银行(深市)
tdx_quotes code="600519" setcode="1" hasProInfo="1" # 贵州茅台(沪市)
setcode:0=深市,1=沪市,2=北交所。
tdx_kline — K线历史数据TdxShare.PBFXT · 请求体:结构化对象tdx_kline code="000001" setcode="0" period="4" wantNum="30" # 日K 最近30根
tdx_kline code="600519" setcode="1" period="6" wantNum="12" # 月K
period:4=日K,5=周K,6=月K,3=60分钟,9=1分钟(完整对照见源码)。
tdx_lookup_stock — 代码/名称检索https://ai.icfqs.com:8965/v1/rag-entity-retrieve(独立于主 API){ query, range }tdx_lookup_stock query="平安银行"
tdx_lookup_stock query="腾讯" range="HK-GP"
range:AG=A股(默认),HK-GP=港股,JJ=基金,MG-GP=美股,ZS=指数 等。
tdx_screener — 自然语言智能选股JNLPSE:wendaQuery · 请求体:[{ message, rang, pageNo, pageSize }]tdx_screener message="涨停"
tdx_screener message="主板 小盘 低价 涨停"
tdx_indicator_select — 指标选择与查询NLPSE:InfoSelectV2 · 请求体:{ message, rang }tdx_indicator_select message="000001 技术指标"
tdx_indicator_select message="银行业估值对比"
tdx_index_list — 主要指数固化清单MAJOR_INDICES 数组(通达信终端"主要指数"模块,2026-10-24 快照),无网络请求。code/setcode/name/exchange/group;分组覆盖宽基规模、创业系、科创系、风格、红利、策略加权、区域、本地特色。group(分组名子串,如 宽基规模)。配合 tdx_quotes/tdx_kline 按 code+setcode 逐只取数,即可在无本地终端环境下实现主要指数数据全云端获取。tdx_index_list # 全部 100 个
tdx_index_list group="宽基规模" # 按分组过滤
tdx_industry_list — 行业板块目录固化清单INDUSTRY_LIST 数组(通达信终端 market=16/17/18,2026-10-24 快照),无网络请求。code/setcode/name/exchange/level,代码均为 881xxx.SH。level(1/2/3/all)、search(名称子串)。云端 tdx_quotes/tdx_kline 对 881 行业指数取数已验证可用(881002 实测)。tdx_industry_list # 全部 503 个
tdx_industry_list level=1 # 仅一级
tdx_industry_list search="煤炭" # 名称子串搜索
注:与
references/industry-index-881.md(467 条三级映射,setcode=1 口径)相比,本清单来自终端 16/17/18 市场快照(503 条,三级 345),口径略有差异、以各自文档标注为准。
所有请求统一在 Header 中携带 Token:
Content-Type: application/json
token: {your_tdx_api_token}
Token 来源优先级:插件配置 tdxApiToken → 环境变量 TDX_API_KEY。
🔒 安全提示:不要把真实 Token 写入源码或提交到仓库。请使用
config.json(已忽略)或环境变量。
Q:OpenClaw 安装时报 validation 警告 / 工具未注册 / 初始化被阻断?
已在 v3.1.2 修复。根因是 plugin id 不匹配:index.js 导出的 id: "tdx-finance" 与 manifest openclaw.plugin.json 的 id: "tdx-finance-mcp" 不一致,OpenClaw 对不上 manifest 就会验证失败、工具不注册(与你填的配置值无关,所以改配置也过不了)。修复方法是把 index.js 的 id/name 对齐成 tdx-finance-mcp / TDX Finance MCP。
升级到 ≥3.1.2 后,config.json 只需填 token:
{ "plugins": { "tdx-finance-mcp": { "enabled": true, "config": { "tdxApiToken": "TDX-你的token" } } } }
然后重新加载插件即可。自定义端点改用环境变量 TDX_API_DATA_ENDPOINT(v3.1.2 起 config 已不含 apiEndpoint 字段)。
附:v3.1.2 也顺手简化了
configSchema(移除format:"uri"、空默认+pattern、additionalProperties:false)作为次要 hardening,但那不是本次安装失败的根因。
Q:如何获取 TDX API Token?
联系通达信官方申请数据服务权限。Token 通常为 TDX-xxxx... 格式。
Q:接口返回 503 / S14042 错误?
通常是 Token 权限不足、服务端维护或网络问题。确认能访问 tdxhub.icfqs.com:7615 与 ai.icfqs.com:8965。
Q:tdx_api_data 能用但 tdx_quotes/tdx_kline 报错?
正常现象——三者使用完全不同的 Entry(TdxSharePCCW.* vs TdxShare.PBHQInfo vs TdxShare.PBFXT)。请勿根据工具名猜测 Entry。
Q:部分 F10 数据返回 E|-7201 / E|-7202?
该模块未在当前 Token 下注册,需联系通达信升级权限。
Q:PowerShell 测试失败但 Node.js 成功?
已知差异。请在 Node.js ≥ 22 环境运行,调试时使用原生 fetch。
tdx_api_data 用 { Params: [...] };tdx_quotes/tdx_kline 用结构化对象;tdx_screener 用数组。本项目基于 MIT License 开源,详见 LICENSE。
通达信(TDX)A股金融数据 MCP 插件-v3— 6 个核心工具(实时行情/K线/F10基本面/智能选股/指标/代码检索)+ 45 个投资分析技能,适配 OpenClaw,经真实接口实测。
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
TDX Finance MCP Plugin V3 ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-27 通达信(TDX)A股金融数据 MCP 插件-v3— 6 个核心工具(实时行情/K线/F10基本面/智能选股/指标/代码检索)+ 45 个投资分析技能,适配 OpenClaw,经真实接口实测。