basedoc-dameng-mcp 0.1.1 → 0.1.2

package/README.md

@@ -1,128 +1,201 @@
-# dameng-mcp
+# basedoc-dameng-mcp
 
-Read-only MCP server for Dameng (DM8). Built after rejecting `zqeast/dameng-mcp-server` for stdout-leaking the password and offering an unguarded `execute_sql`.
+面向达梦数据库 (DM8) 的只读 MCP 服务，附带**本地 Markdown 手册**的离线全文检索能力。把"运维问答"和"翻手册"这两件事做成 LLM 直接可调用的工具，让 Claude / 其它 MCP 客户端在一次会话里既能问数据库当前状态，也能查官方文档。
 
-## Guarantees
+整套搜索能力**完全离线**——内网部署的达梦客户也能用。
 
-- **Read-only at the application layer.** Only `SELECT` / `WITH` / `EXPLAIN` are accepted. Multi-statement input is rejected. Leading line/block comments are stripped before classification, so `-- foo\nDROP TABLE t` is also rejected.
-- **No password fallback.** `DAMENG_PASSWORD` must be set; missing → exit 2. Nothing defaults to `SYSDBA`.
-- **stderr-only logging.** stdio's stdout is the JSON-RPC channel — every log line goes through `console.error`.
-- **Timeout + row cap.** Every query is bounded by `DAMENG_QUERY_TIMEOUT_MS` (default 10s) and capped at `DAMENG_MAX_ROWS` (default 1000). On timeout the underlying connection is closed.
-- **Pinned dependencies.** `dmdb`, `@modelcontextprotocol/sdk`, and `zod` are all locked to exact versions.
+---
 
-The first line of defense is still **using a low-privilege Dameng account**. The app-layer guard is belt-and-braces; the database account should not have DML/DDL grants in the first place.
+## 快速开始
 
-## Provision a read-only DB user
+接入这个 MCP 需要先准备一个 markdown 手册目录（用作搜索语料）。两条路：
 
-```sql
-CREATE USER MCP_RO IDENTIFIED BY "<strong-password>";
-GRANT CONNECT TO MCP_RO;
-GRANT SELECT ON <schema>.<table> TO MCP_RO;
--- or grant on a whole schema you trust:
--- GRANT SELECT ANY TABLE TO MCP_RO;
-GRANT SELECT ON V$INSTANCE TO MCP_RO;
-GRANT SELECT ON V$DATABASE TO MCP_RO;
+### 路径 A：你已经有 markdown 手册目录
+
+直接跳到下面的 [接入 Claude Code](#接入-claude-code)，把 `DAMENG_DOCS_ROOT` 指过去。
+
+### 路径 B：你还没有，从达梦官方文档站抓一份
+
+包内置了一个抓取转换工具（`basedoc-dameng-fetch-docs`），从 https://eco.dameng.com 拉所有手册并自动转 markdown，写到本地目录：
+
+```bash
+npx -y basedoc-dameng-mcp basedoc-dameng-fetch-docs ~/.dameng-docs
+# 或者直接调 bin：
+npx -y -p basedoc-dameng-mcp basedoc-dameng-fetch-docs ~/.dameng-docs
+```
+
+完成后会得到 22 本手册、~250 个章节、~9 MB 的 markdown 目录，下面像这样：
+
+```
+~/.dameng-docs/
+├── README.md
+├── DM8-系统管理员手册/
+│   ├── system-administrator.md
+│   ├── physical-storage-structure.md
+│   └── ...
+├── DM8-SQL 语言使用手册/
+├── DM8-安全管理/
+└── ...
 ```
 
-## Build
+抓取过程默认 5 并发、约 2-3 秒结束。需要联通 `eco.dameng.com`——内网/隔离环境跑不了，请走路径 A 或者在能联网的机器上抓完后再 rsync 进内网。
+
+> **关于版权**：抓取下来的内容版权属于**达梦数据库股份有限公司**，仅供个人/团队内部参考使用，**不要公开发布**。
+
+---
+
+## 接入 Claude Code
 
 ```bash
-npm install
-npm run build
+claude mcp add dameng \
+  --scope user \
+  -e DAMENG_DOCS_ROOT="$HOME/.dameng-docs" \
+  -e DAMENG_DOCS_INCLUDE='DM8-*' \
+  -e DAMENG_HOST=<达梦主机> \
+  -e DAMENG_PORT=5236 \
+  -e DAMENG_USER=MCP_RO \
+  -e DAMENG_PASSWORD=<密码> \
+  -- npx -y basedoc-dameng-mcp
 ```
 
-## Modes
+不需要数据库工具的话，所有 `DAMENG_HOST` / `PORT` / `USER` / `PASSWORD` 都可以省略——只剩文档检索能力（**仅文档模式**）。
 
-The server supports two run modes, picked automatically from env vars:
+---
 
-- **DB + docs mode** (set both DB credentials and `DAMENG_DOCS_ROOT`): all 8 tools registered.
-- **Docs-only mode** (set only `DAMENG_DOCS_ROOT`, no DB credentials): just the 4 docs tools — useful when you want to ship Dameng manuals to an LLM without exposing the database.
-- (DB-only mode also works if you set DB creds without `DAMENG_DOCS_ROOT`.)
+## 启动模式
 
-Server fails fast (exit 2) if neither set is provided.
+按环境变量自动判定：
 
-## Configuration (env vars)
+| 给的环境变量 | 启动什么 |
+| --- | --- |
+| 完整 DB 凭据 + `DAMENG_DOCS_ROOT` | 全部 8 个工具 |
+| 只有 DB 凭据 | 只 4 个 DB 工具 |
+| 只有 `DAMENG_DOCS_ROOT` | 只 4 个文档工具——适合"只让 LLM 看手册、不暴露数据库" |
+| 都没有 | exit 2 |
 
-| Variable | Required | Default | Notes |
-|---|---|---|---|
-| `DAMENG_HOST` | for DB | — | e.g. `dameng.example.com` |
-| `DAMENG_PORT` | for DB | — | e.g. `5236` |
-| `DAMENG_USER` | for DB | — | low-privilege account |
-| `DAMENG_PASSWORD` | for DB | — | no fallback |
-| `DAMENG_SCHEMA` | no | — | default schema for `list_tables` / `describe_table` |
-| `DAMENG_QUERY_TIMEOUT_MS` | no | `10000` | per-query timeout |
-| `DAMENG_MAX_ROWS` | no | `1000` | hard cap on returned rows |
-| `DAMENG_POOL_MIN` | no | `1` | |
-| `DAMENG_POOL_MAX` | no | `4` | |
-| `DAMENG_DOCS_ROOT` | no | — | absolute path to a directory of Markdown manuals. Enables the docs tools. |
-| `DAMENG_DOCS_INCLUDE` | no | — | comma-separated top-level dir patterns to include (glob `*` supported). Recommended: `DM8-*` to scope to official manuals only. |
-| `DAMENG_DOCS_EXCLUDE` | no | — | comma-separated top-level dir patterns to exclude. `node_modules` is always excluded. |
-| `DAMENG_NO_LEGACY_OPENSSL` | no | unset | Set to `1` to skip the auto-relaunch with `--openssl-legacy-provider` (only useful if your dmdb build doesn't need it). |
+---
 
-## Tools
+## 工具
 
-### Database (require DB connection)
-- `query(sql)` — run a single read-only statement.
-- `list_tables(schema?)` — tables in a schema (defaults to `DAMENG_SCHEMA` or current user).
-- `describe_table(table, schema?)` — columns + types for one table.
-- `instance_status()` — `V$INSTANCE` + `V$DATABASE` snapshot.
+### 数据库（需要 DB 凭据）
 
-### Docs (require `DAMENG_DOCS_ROOT`)
-- `list_manuals()` — discover what manuals exist; each entry has `fileCount` and a short index summary (from `00-目录索引.md` or `README.md`).
-- `list_sections(manual)` — list `.md` chapters in one manual with their H1/H2 headings (with line numbers).
-- `read_section(file, heading?, maxBytes?)` — read a chapter or a single heading-bounded section. Use this to pull full context after a `lookup_docs` hit.
-- `lookup_docs(query, manual?, regex?, maxMatches?)` — keyword/regex search. Results are **grouped by section** (file + nearest heading), each match has line ± 1 line of context, sections sorted by match count descending.
+| 工具 | 说明 |
+| --- | --- |
+| `query(sql)` | 执行单条只读 SQL |
+| `list_tables(schema?)` | 列某 schema 下的表 |
+| `describe_table(table, schema?)` | 列字段名 / 类型 / 是否可空 / 默认值 |
+| `instance_status()` | `V$INSTANCE` + `V$DATABASE` 当前快照 |
 
-**Recommended workflow** for the LLM client:
-1. `list_manuals()` → know what's available
-2. `lookup_docs("keyword", manual: "DM8-...")` → find candidate sections
-3. `read_section(file, heading)` → pull the full passage
-4. Synthesize the answer for the user
+### 文档（需要 `DAMENG_DOCS_ROOT`）
 
-### Safety
-- `list_tables` / `describe_table` build their SQL internally and only accept identifier-shaped input (`[A-Za-z_][A-Za-z0-9_]*`).
-- All docs tools only read `.md` files under `DAMENG_DOCS_ROOT`. `manual` and `file` parameters reject `..`, leading `.`, leading `/`, and other unsafe segments — no path traversal. `node_modules` directories are never walked.
+| 工具 | 说明 |
+| --- | --- |
+| `list_manuals()` | 根目录下都有哪些手册（用 `00-目录索引.md` / `README.md` 当摘要） |
+| `list_sections(manual)` | 某本手册里有哪些 .md 章节，每个带 H1 / H2 标题 + 行号 |
+| `read_section(file, heading?, maxBytes?)` | 读整个章节文件；带 heading 则只切出对应小节 |
+| `lookup_docs(query, manual?, regex?, maxMatches?)` | 全文检索；按 (文件 + 最近 heading) 分组，每条带 ±1 行上下文，按命中数倒序 |
 
-## Register with Claude Code
+### 给 LLM 客户端的推荐工作流
 
-```bash
-claude mcp add dameng-prod \
-  -e DAMENG_HOST=<your-dameng-host> \
-  -e DAMENG_PORT=5236 \
-  -e DAMENG_USER=MCP_RO \
-  -e DAMENG_PASSWORD=<password> \
-  -e DAMENG_SCHEMA=<your-schema> \
-  -e DAMENG_DOCS_ROOT=/path/to/dameng-docs \
-  -e DAMENG_DOCS_INCLUDE='DM8-*' \
-  -- npx -y basedoc-dameng-mcp
+```
+list_manuals()
+  ↓
+lookup_docs(query, manual="DM8-...")
+  ↓
+read_section(file, heading="...")
+  ↓
+（合成回答）
 ```
 
-Or, if you cloned the repo and want to run from source:
+`list_tables` 和 `describe_table` 内部生成 SQL，对入参做严格的标识符正则校验（`[A-Za-z_][A-Za-z0-9_]*`），不会拼接出注入。
 
-```bash
-  -- node /path/to/basedoc-dameng-mcp/dist/server.js
+---
+
+## 取舍清单
+
+不该让 LLM 做的事，挡在工具调用之前：
+
+- SQL 入参只放 `SELECT` / `WITH` / `EXPLAIN`，多语句 / 注释绕过 / `DROP` 之类的关键字一律拒绝
+- `DAMENG_PASSWORD` 不写也不补——缺失就直接退出 (exit 2)，不存在 SYSDBA 兜底
+- stdout 留给 JSON-RPC，所有日志都走 stderr
+- 每个查询带超时 + 行数硬上限
+- 文档相关的工具不能跨出 `DAMENG_DOCS_ROOT` 边界——`..`、绝对路径、`node_modules` 全部拦截
+- 关键依赖（`@modelcontextprotocol/sdk`、`dmdb`、`zod`、`turndown`）锁死精确版本
+
+---
+
+## 环境变量
+
+| 变量 | 何时必填 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| `DAMENG_HOST` | DB 模式 | — | 达梦服务器地址 |
+| `DAMENG_PORT` | DB 模式 | — | 比如 `5236` |
+| `DAMENG_USER` | DB 模式 | — | 推荐建低权账号 |
+| `DAMENG_PASSWORD` | DB 模式 | — | 没有任何兜底 |
+| `DAMENG_SCHEMA` | 否 | — | `list_tables` / `describe_table` 默认查的 schema |
+| `DAMENG_QUERY_TIMEOUT_MS` | 否 | `10000` | 单次查询超时 |
+| `DAMENG_MAX_ROWS` | 否 | `1000` | 单次返回行数硬上限 |
+| `DAMENG_POOL_MIN` / `DAMENG_POOL_MAX` | 否 | `1` / `4` | 连接池上下限 |
+| `DAMENG_DOCS_ROOT` | 文档模式 | — | 含 markdown 的目录的**绝对路径** |
+| `DAMENG_DOCS_INCLUDE` | 否 | — | 顶层目录白名单，逗号分隔，支持 `*` 通配，例如 `DM8-*` |
+| `DAMENG_DOCS_EXCLUDE` | 否 | — | 顶层目录黑名单。`node_modules` 永远硬排，无需手动加 |
+| `DAMENG_NO_LEGACY_OPENSSL` | 否 | 不设 | 设 `1` 跳过下文那个自重启 |
+
+---
+
+## 准备一个低权数据库账号
+
+直接给 SYSDBA 跑也能用——SQL 守卫已经限死只读——但纵深防御原则下建议：
+
+```sql
+CREATE USER MCP_RO IDENTIFIED BY "<强密码>";
+GRANT SELECT ANY TABLE TO MCP_RO;
+GRANT SELECT ON V$INSTANCE TO MCP_RO;
+GRANT SELECT ON V$DATABASE TO MCP_RO;
 ```
 
-Register one MCP server per Dameng instance. If the same box hosts multiple instances on different ports, use distinct names like `dameng-prod-a` / `dameng-prod-b`.
+注：达梦中 `CREATE USER` 后默认就有 session 权限，无需 `GRANT CONNECT`（这条会报语法错）。
 
-## Tests
+---
 
-```bash
+## 二进制为什么会自重启
+
+`dmdb` 驱动握手阶段使用了 OpenSSL 3 在 Node 17+ 默认禁用的算法。不带 `--openssl-legacy-provider` 启动 Node 时会报 `[6071] 消息加密失败` / `error:0308010C`。本包的 bin 入口检测到没带这个 flag 就自己 spawn 一次新进程加上，对调用者透明。代价是约 50ms 的额外启动。如果你的 dmdb 版本不需要，设 `DAMENG_NO_LEGACY_OPENSSL=1` 跳过。
+
+---
+
+## 测试
+
+```
 npm test
 ```
 
-Tests cover the SQL guard (rejection rules, comment stripping, multi-statement detection), the config loader (required vars, no password fallback, type validation, docs-root + include/exclude validation), the timeout helper, and the docs layer (`searchDocs` grouping/ranking/context, `listManuals`, `listSections`, `readSection` heading extraction + path-traversal safety). The dmdb integration is not unit-tested; verify it by pointing at a real instance.
+117 个用例，覆盖：
+
+- SQL 守卫的关键字白名单 / 注释剥离 / 多语句检测
+- 配置加载，包括无 SYSDBA 兜底的明确断言、include/exclude 解析
+- 超时 helper
+- 4 个文档函数：搜索分组与排名、目录列出、章节按 heading 切片读取、路径越权防护
+- HTML→MD 抓取链路：sidebar 解析、article 抽取、turndown 包装
+
+dmdb 与 MCP 协议握手部分没有单元测试，需要指向真实达梦实例验证。
+
+---
+
+## 故意不做的能力
+
+- 不暴露 DML / DDL / 系统过程调用——写入操作请直接走 dmctl 或 JDBC
+- 不开 HTTP transport——只 stdio，没有可被外部访问的网络面
+- 启动时不做 schema 自检——按需查系统视图，避免不必要的握手成本
 
-## What is NOT here, by design
+---
 
-- No `execute_sql` / no DML / no DDL. If you need writes, write them directly with `dmctl`/JDBC, not through an LLM.
-- No HTTP transport. stdio only — no inbound network surface.
-- No automatic schema introspection on startup. Tools query system views on demand.
+## 已知传递依赖告警
 
-## Why does the binary self-relaunch?
+`npm audit` 会标记 `@modelcontextprotocol/sdk` HTTP transport 链（`express-rate-limit` → `ip-address`）以及开发环境 Vitest / Vite 链上的几个中等漏洞。本服务只跑 stdio transport，HTTP 那条链不会被加载；Vitest 是开发依赖不进入运行时。等上游升级后会自动消失，不会用 `npm audit fix --force` 强行覆盖。
 
-`dmdb`'s login handshake uses encryption algorithms OpenSSL 3 disabled by default in Node 17+. Without `--openssl-legacy-provider` you get `[6071] 消息加密失败` / `error:0308010C`. Rather than asking every user to set `NODE_OPTIONS=--openssl-legacy-provider`, the bin re-execs itself with the flag on first start. Cost is one extra ~50 ms Node startup. Opt out with `DAMENG_NO_LEGACY_OPENSSL=1`.
+---
 
-## Known transitive vulnerabilities
+## 许可证
 
-`npm audit` flags issues in `@modelcontextprotocol/sdk`'s HTTP transport chain (`express-rate-limit` → `ip-address`) and in the dev-only Vitest/Vite chain. The stdio server we ship doesn't load the HTTP transport, and Vitest isn't part of the runtime. These will clear when upstream bumps; we don't paper over them with `npm audit fix --force`.
+MIT。详见 [LICENSE](./LICENSE)。

package/dist/bin-fetch.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fetchAndConvertAll } from "./fetch-docs.js";
+const DEFAULT_SOURCE = "https://eco.dameng.com/document/dm/zh-cn/pm/";
+function usage() {
+    process.stderr.write([
+        "用法: basedoc-dameng-fetch-docs <目标目录> [--source <URL>] [--concurrency <N>]",
+        "",
+        "  从达梦官方在线文档抓取所有手册并转换为 Markdown，写入指定目录。",
+        "  目标目录可以直接当作 DAMENG_DOCS_ROOT 给 basedoc-dameng-mcp 使用。",
+        "",
+        "选项:",
+        "  --source <URL>      达梦文档站点的索引页 URL",
+        `                      默认: ${DEFAULT_SOURCE}`,
+        "  --concurrency <N>   并发下载数 (默认 5)",
+        "  -h, --help          显示帮助",
+        "",
+        "示例:",
+        "  basedoc-dameng-fetch-docs ~/.dameng-docs",
+        "  npx -y basedoc-dameng-mcp/dist/bin-fetch.js ~/.dameng-docs",
+        "",
+        "注意: 抓取到的内容版权属于达梦数据库股份有限公司。仅供个人或团队",
+        "      内部使用，不要公开再发布。",
+        "",
+    ].join("\n"));
+    process.exit(2);
+}
+function parseArgs(argv) {
+    let target;
+    let source = DEFAULT_SOURCE;
+    let concurrency = 5;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "-h" || a === "--help")
+            usage();
+        else if (a === "--source")
+            source = argv[++i] ?? usage();
+        else if (a === "--concurrency")
+            concurrency = parseInt(argv[++i] ?? "", 10) || usage();
+        else if (a.startsWith("-")) {
+            process.stderr.write(`未知选项: ${a}\n`);
+            usage();
+        }
+        else if (!target)
+            target = a;
+        else {
+            process.stderr.write(`只支持一个目标目录参数，已经是 ${target}\n`);
+            usage();
+        }
+    }
+    if (!target)
+        usage();
+    if (concurrency < 1 || concurrency > 20) {
+        process.stderr.write(`concurrency 取值必须在 1–20 之间，得到 ${concurrency}\n`);
+        process.exit(2);
+    }
+    return { target: resolve(target), source, concurrency };
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    process.stderr.write(`目标目录: ${args.target}\n`);
+    process.stderr.write(`源站点: ${args.source}\n`);
+    process.stderr.write(`并发: ${args.concurrency}\n\n`);
+    const t0 = Date.now();
+    const result = await fetchAndConvertAll({
+        source: args.source,
+        targetDir: args.target,
+        concurrency: args.concurrency,
+        onProgress: (m) => process.stderr.write(m + "\n"),
+    });
+    const elapsed = ((Date.now() - t0) / 1000).toFixed(1);
+    process.stderr.write(`\n完成: ${result.manualCount} 本手册, ${result.chapterCount} 个章节, ${elapsed}s\n`);
+    if (result.failures.length > 0) {
+        process.stderr.write(`\n失败 ${result.failures.length} 个章节:\n`);
+        for (const f of result.failures) {
+            process.stderr.write(`  ${f.url}: ${f.error}\n`);
+        }
+        process.stderr.write(`\n可以重新运行同一条命令来重试 (已成功的章节会被覆盖)。\n`);
+        process.exit(1);
+    }
+    process.stderr.write(`\n下一步: 把 ${args.target} 当 DAMENG_DOCS_ROOT 用，例如:\n` +
+        `  claude mcp add dameng \\\n` +
+        `    --scope user \\\n` +
+        `    -e DAMENG_DOCS_ROOT="${args.target}" \\\n` +
+        `    -e DAMENG_DOCS_INCLUDE='DM8-*' \\\n` +
+        `    -- npx -y basedoc-dameng-mcp\n`);
+}
+main().catch((e) => {
+    process.stderr.write(`[fetch-docs] 错误: ${e instanceof Error ? e.message : String(e)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin-fetch.js.map

package/dist/bin-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-fetch.js","sourceRoot":"","sources":["../src/bin-fetch.ts"],"names":[],"mappings":"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"}

package/dist/fetch-docs.js

@@ -0,0 +1,175 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import TurndownService from "turndown";
+const ICONFONT_RANGE = /[-]/g;
+const HTML_ICONFONT_ENTITY = /&#x[eE][0-9a-fA-F]{3};/g;
+export function normalizeManualName(raw) {
+    return raw
+        .replace(HTML_ICONFONT_ENTITY, "")
+        .replace(ICONFONT_RANGE, "")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/^DM8\s+/, "DM8-");
+}
+export function parseManualsFromSidebar(html) {
+    // Each manual is rendered as `<div class="left-sidebar-link-group top" ...>`
+    // The literal string `left-sidebar-link-group` also appears inside <script>
+    // blocks for the toggle animation; we anchor to the `top` modifier so we
+    // only match the actual HTML wrappers.
+    const blockRe = /<div\s+class="left-sidebar-link-group top"[^>]*>/g;
+    const positions = [];
+    let mm;
+    while ((mm = blockRe.exec(html)) !== null)
+        positions.push(mm.index);
+    const out = [];
+    for (let i = 0; i < positions.length; i++) {
+        const start = positions[i];
+        const end = i + 1 < positions.length ? positions[i + 1] : html.length;
+        let block = html.slice(start, end);
+        // Bound to the closing of this group's container — the `bar-border`
+        // separator that always follows a finished group.
+        const closeAt = block.search(/<div\s+class="bar-border"/);
+        if (closeAt > 0)
+            block = block.slice(0, closeAt);
+        // Manual name is the first font-weight:800 anchor in the block.
+        const titleMatch = block.match(/<a[^>]*font-weight:\s*800;?[^>]*>([\s\S]*?)<\/a>/);
+        if (!titleMatch)
+            continue;
+        const rawTitle = titleMatch[1].replace(/<[^>]+>/g, "");
+        const manual = normalizeManualName(rawTitle);
+        if (!manual.startsWith("DM8-"))
+            continue;
+        const chapters = [];
+        const chapterRe = /<a[^>]*href="([^"]+\.html)"[^>]*>([\s\S]*?)<\/a>/g;
+        let m;
+        while ((m = chapterRe.exec(block)) !== null) {
+            const href = m[1];
+            if (!href.endsWith(".html") || href.includes("/") || href.includes(":"))
+                continue;
+            const title = m[2].replace(/<[^>]+>/g, "").replace(ICONFONT_RANGE, "").trim();
+            if (!title)
+                continue;
+            chapters.push({ href, title });
+        }
+        if (chapters.length > 0)
+            out.push({ manual, chapters });
+    }
+    return out;
+}
+export function extractArticleHtml(html) {
+    // The eco.dameng.com pages wrap the actual chapter content in
+    //   <div class="article-content vditor-reset" ...> ... </div>
+    // followed by a <footer class="article-footer"> we want to drop.
+    const m = html.match(/<div\s+class="article-content[^"]*"[^>]*>([\s\S]*?)<(?:footer|div|aside)[^>]*\sclass="article-footer/);
+    return m ? m[1].trim() : "";
+}
+let _turndown = null;
+function turndown() {
+    if (_turndown)
+        return _turndown;
+    const t = new TurndownService({
+        headingStyle: "atx",
+        codeBlockStyle: "fenced",
+        bulletListMarker: "-",
+        emDelimiter: "*",
+    });
+    // Drop the inline anchor links Hexo adds after every heading.
+    t.addRule("strip-article-anchor", {
+        filter: (node) => node.nodeName === "A" &&
+            (node.getAttribute("class") || "").includes("article-anchor"),
+        replacement: () => "",
+    });
+    // Drop "copy code" buttons commonly added by docs sites.
+    t.addRule("strip-copy-button", {
+        filter: (node) => node.nodeName === "BUTTON" ||
+            (node.getAttribute("class") || "").includes("copy"),
+        replacement: () => "",
+    });
+    _turndown = t;
+    return t;
+}
+export function htmlToMarkdown(html) {
+    return turndown().turndown(html).trim() + "\n";
+}
+export async function fetchAndConvertAll(opts) {
+    const concurrency = opts.concurrency ?? 5;
+    const log = opts.onProgress ?? (() => { });
+    const baseUrl = opts.source.endsWith("/") ? opts.source : opts.source + "/";
+    log(`fetching index: ${baseUrl}`);
+    const indexHtml = await fetchText(baseUrl);
+    const manuals = parseManualsFromSidebar(indexHtml);
+    if (manuals.length === 0) {
+        throw new Error(`No manuals found in sidebar at ${baseUrl}. Did the site structure change?`);
+    }
+    log(`found ${manuals.length} manuals, ${manuals.reduce((n, m) => n + m.chapters.length, 0)} chapters total`);
+    await mkdir(opts.targetDir, { recursive: true });
+    await writeFile(join(opts.targetDir, "README.md"), `# Dameng manuals (auto-fetched)\n\nGenerated from ${baseUrl} at ${new Date().toISOString()}.\n\nCopyright belongs to 达梦数据库股份有限公司. Kept locally for personal/team reference.\n`, "utf8");
+    const tasks = [];
+    for (const group of manuals) {
+        const dir = join(opts.targetDir, group.manual);
+        await mkdir(dir, { recursive: true });
+        for (const ch of group.chapters) {
+            tasks.push({
+                manual: group.manual,
+                chapter: ch,
+                url: baseUrl + ch.href,
+                outPath: join(dir, ch.href.replace(/\.html$/, ".md")),
+            });
+        }
+    }
+    const failures = [];
+    let completed = 0;
+    const total = tasks.length;
+    async function worker(slice) {
+        for (const t of slice) {
+            try {
+                const html = await fetchText(t.url);
+                const article = extractArticleHtml(html);
+                if (!article)
+                    throw new Error("no article body in HTML");
+                const md = `# ${t.chapter.title}\n\n` + htmlToMarkdown(article);
+                await writeFile(t.outPath, md, "utf8");
+            }
+            catch (e) {
+                failures.push({ url: t.url, error: e instanceof Error ? e.message : String(e) });
+            }
+            completed++;
+            if (completed % 10 === 0 || completed === total) {
+                log(`  [${completed}/${total}] ${t.manual} :: ${t.chapter.title}`);
+            }
+        }
+    }
+    // Slice tasks evenly across workers.
+    const slices = Array.from({ length: concurrency }, () => []);
+    tasks.forEach((t, i) => slices[i % concurrency].push(t));
+    await Promise.all(slices.map((s) => worker(s)));
+    return {
+        manualCount: manuals.length,
+        chapterCount: tasks.length,
+        failures,
+    };
+}
+async function fetchText(url, retries = 2) {
+    let lastErr;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            const res = await fetch(url, {
+                headers: {
+                    "User-Agent": "basedoc-dameng-mcp/0.1.2 (+https://github.com/bravejack/basedoc-dameng-mcp)",
+                    "Accept": "text/html",
+                },
+            });
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status} for ${url}`);
+            return await res.text();
+        }
+        catch (e) {
+            lastErr = e;
+            if (attempt < retries) {
+                await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
+            }
+        }
+    }
+    throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+}
+//# sourceMappingURL=fetch-docs.js.map

package/dist/fetch-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-docs.js","sourceRoot":"","sources":["../src/fetch-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,eAAe,MAAM,UAAU,CAAC;AAYvC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEhC,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAEvD,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,GAAG;SACP,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE;SACN,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,6EAA6E;IAC7E,4EAA4E;IAC5E,yEAAyE;IACzE,uCAAuC;IACvC,MAAM,OAAO,GAAG,mDAAmD,CAAC;IACpE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,EAA0B,CAAC;IAC/B,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI;QAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAEpE,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACvE,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnC,oEAAoE;QACpE,kDAAkD;QAClD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC1D,IAAI,OAAO,GAAG,CAAC;YAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAEjD,gEAAgE;QAChE,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAC5B,kDAAkD,CACnD,CAAC;QACF,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAEzC,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,mDAAmD,CAAC;QACtE,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClF,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/E,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,8DAA8D;IAC9D,8DAA8D;IAC9D,iEAAiE;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAClB,sGAAsG,CACvG,CAAC;IACF,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,IAAI,SAAS,GAA2B,IAAI,CAAC;AAC7C,SAAS,QAAQ;IACf,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,eAAe,CAAC;QAC5B,YAAY,EAAE,KAAK;QACnB,cAAc,EAAE,QAAQ;QACxB,gBAAgB,EAAE,GAAG;QACrB,WAAW,EAAE,GAAG;KACjB,CAAC,CAAC;IACH,8DAA8D;IAC9D,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE;QAChC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACf,IAAI,CAAC,QAAQ,KAAK,GAAG;YACrB,CAAE,IAAoB,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAChF,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE;KACtB,CAAC,CAAC;IACH,yDAAyD;IACzD,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE;QAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACf,IAAI,CAAC,QAAQ,KAAK,QAAQ;YAC1B,CAAE,IAAoB,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtE,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE;KACtB,CAAC,CAAC;IACH,SAAS,GAAG,CAAC,CAAC;IACd,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;AACjD,CAAC;AAeD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAe;IACtD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IAE5E,GAAG,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,kCAAkC,CAAC,CAAC;IAC/F,CAAC;IACD,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE7G,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,qDAAqD,OAAO,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,oFAAoF,EAC/K,MAAM,CACP,CAAC;IAEF,MAAM,KAAK,GAAyE,EAAE,CAAC;IACvF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,EAAE;gBACX,GAAG,EAAE,OAAO,GAAG,EAAE,CAAC,IAAI;gBACtB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAE3B,KAAK,UAAU,MAAM,CAAC,KAAmB;QACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACpC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBACzD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;gBAChE,MAAM,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnF,CAAC;YACD,SAAS,EAAE,CAAC;YACZ,IAAI,SAAS,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;gBAChD,GAAG,CAAC,MAAM,SAAS,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,MAAM,GAAmB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7E,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhD,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,YAAY,EAAE,KAAK,CAAC,MAAM;QAC1B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,OAAO,GAAG,CAAC;IAC/C,IAAI,OAAgB,CAAC;IACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,OAAO,EAAE;oBACP,YAAY,EAAE,6EAA6E;oBAC3F,QAAQ,EAAE,WAAW;iBACtB;aACF,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC;YAC9D,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,CAAC;YACZ,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "basedoc-dameng-mcp",
-  "version": "0.1.1",
-  "description": "Read-only MCP server for Dameng (DM8): SQL whitelist + local Markdown manual search (list_manuals / list_sections / read_section / lookup_docs).",
+  "version": "0.1.2",
+  "description": "面向达梦数据库 (DM8) 的只读 MCP 服务：受限 SQL 查询 + 本地 Markdown 手册离线全文检索（list_manuals / list_sections / read_section / lookup_docs）。",
   "type": "module",
   "license": "MIT",
   "author": "bravejack",
@@ -24,7 +24,8 @@
     "documentation"
   ],
   "bin": {
-    "basedoc-dameng-mcp": "dist/server.js"
+    "basedoc-dameng-mcp": "dist/server.js",
+    "basedoc-dameng-fetch-docs": "dist/bin-fetch.js"
   },
   "main": "dist/server.js",
   "files": [
@@ -33,7 +34,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json && chmod +x dist/server.js",
+    "build": "tsc -p tsconfig.json && chmod +x dist/server.js dist/bin-fetch.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "start": "node dist/server.js",
@@ -42,10 +43,12 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
     "dmdb": "1.0.48286",
+    "turndown": "7.2.4",
     "zod": "4.4.3"
   },
   "devDependencies": {
     "@types/node": "22.10.2",
+    "@types/turndown": "5.0.6",
     "typescript": "5.7.2",
     "vitest": "2.1.8"
   },