A 股产业链图谱 helibeiqi/dsh-industry-graph-mcp

dsh-industry-graph-mcp

零依赖 · 本地优先的 A股 产业链 / 申万行业 / 概念板块 知识图谱 MCP server。
无需 API key、无需联网，纯 Node.js（ESM）读取内置精选种子数据，供 DeepSeek Harness (dsh) 在对话中直接调用。

为什么做这个（定位）

在 dsh 插件生态里，办公文档生成（docx / pdf / pptx / excel）已是红海（竞品 30–215 个不等）；而 中文 HR / 合规本地化（薪酬 / 个税 / 社保 / 劳动合同，全 GitHub 检索 0 竞品）是真正经得起复核的蓝海。

⚠️ 诚实声明（2026-08-28 晚修正）：本插件所属的「A股 产业链 / 行业 / 概念图谱」方向并非蓝海——全 GitHub 已有 40–61 个 A股 数据 MCP，且存在与本插件近乎同构的 jinjunnn/tide-plugin（产业链/概念/题材图谱）等竞品。本插件的价值在于 local-first / 零依赖 / 无 API key / 随仓精选种子，作为领域知识资产与 portfolio 拼图成立，但不是首发占位。不建议在该方向继续扩面。

本插件不比拼"再生成一个文档"，而是把A股 实体关系的领域知识做成可被大模型实时查询的本地图谱：当策略研究 / 投研对话中需要"这只票属于什么行业、和谁同业、处在产业链哪一环、沾哪些题材"时， agent 不再靠记忆硬猜，而是调用本 server 拿到结构化、可追溯的答案。

数据规模（v0.1.0 种子）

| 维度 | 数量 |
| 申万一级行业 | 31（完整一级） |
| 概念板块 | 52 |
| 产业链 | 14（含上/中/下游节点） |
| 覆盖个股 | 181（去重） |

数据为人工精选种子，刻意小而准，覆盖主流赛道；设计为可扩展（见下文"扩展数据"）。

工具清单（7 个）

| 工具 | 说明 | 关键参数 |
| industry_of_stock | 查个股所属申万一级行业 + 关联概念 + 所在产业链 | stock（代码或名称） |
| peers | 同行业竞品（同业可比标的），可剔除自身 | stock, exclude_self |
| chain_view | 查看产业链上下游结构，可高亮某股票所在环节与上下游 | chain（id/名称）, stock |
| concept_members | 查询某概念板块成分股 | concept |
| concept_intersect | 两个概念的交集成分股（概念交叉选股） | a, b |
| stock_search | 按代码/名称子串模糊搜索覆盖标的 | query |
| graph_stats | 数据集规模概览 | — |

所有工具返回 UTF-8 JSON 文本，便于 agent 二次推理或直接呈现。

调用示例（dsh 对话）

- "宁德时代在哪个产业链、处在哪一环？上下游都有谁？"
→ chain_view({chain:"锂电池产业链", stock:"300750"})
- "白酒板块有哪些票？"
→ concept_members({concept:"白酒"})
- "同时沾半导体和 CPO 的票有哪些？"
→ concept_intersect({a:"半导体", b:"CPO"})
- "隆基绿能的同业竞品是谁？"
→ peers({stock:"601012"})

安装 / 接入 dsh

本仓库是一个 dsh bundle。把 cordis.patch.yml 合并进你的 dsh profile 即可注册为一个 mcp server。

cordis.patch.yml 中的关键路径（部署时改成你本机实际路径）：

- insert:
- path: plugins.mcp-servers
items:
- id: mcp-industry-graph
name: A股产业链知识图谱 transport: stdio
command: !!js process.env.QUANT_MCP_NODE || process.execPath
args:
- "C:\\Users\\helib\\dsh-industry-graph-mcp\\industry-graph-mcp-server.mjs"
cwd: "C:\\Users\\helib\\dsh-industry-graph-mcp"
enabled: true

command 使用 !!js process.env.QUANT_MCP_NODE || process.execPath 的硬核写法，
可免疫本机 Node 版本目录漂移（如 22.22.2 → 22.22.2-2）。

本地独立验证（不依赖 dsh）

1) 生成数据（已生成可跳过）
python gen_graph.py

2) 自测 MCP 握手与各工具
python _selftest.py

扩展数据

种子数据集中在 gen_graph.py，三个列表即可扩展：

- industries：申万一级行业 → 代表性成分 (code, name, [(code,name), ...])
- concepts：概念板块 → 成分 [(name, [(code,name), ...])]
- chains：产业链 → 上/中/下游节点 {id, name, nodes:[{stage, desc, members}]}

改完运行 python gen_graph.py 重新生成 data/industry-graph.json，server 自动加载，无需改任何代码。

后续可导入用户自有清单（如自建题材池、自定义产业链），做到"本地优先 + 个人知识沉淀"。

架构要点

- 零依赖：纯 Node ESM + fs，无 npm install，免疫 managed-node 漂移。
- 本地优先：数据来自内置 data/industry-graph.json，不触网、不依赖第三方 API。
- 标准 MCP stdio：initialize → notifications/initialized → tools/list → tools/call，协议版本 2024-11-05，NDJSON 行协议。

许可证

MIT © helibeiqi