J
jackjin1997/markindex
Vectorless, structure-first retrieval over large Markdown libraries for AI agents — a TypeScript take on PageIndex for Markdown (CLI + MCP + AI SDK)
在 GitHub 查看 ↗链接已于 2026-11-12 核查 · HTTP 200 · 打开的是厂商自己的官网
安装与配置
- 复制上面的命令
- 粘成
claude_desktop_config.json里mcpServers的一项（本地服务器用 command + args，示例见 客户端接法） - 重启客户端
客户端配置（取自该仓库的安装命令）
{
"mcpServers": {
"jackjin1997-markindex": {
"command": "npx",
"args": ["-p", "markindex", "-p"]
}
}
}解析自我们于 2026-11-03 抓取的该仓库 README；我们未执行过。
command/args 来自仓库写明的安装命令；不确定时请以该项目 README 为准。
VS Code（.vscode/mcp.json —— 键名是 servers）
{
"servers": {
"jackjin1997-markindex": {
"command": "npx",
"args": ["-p", "markindex", "-p"]
}
}
}VS Code 顶层键是 <code>servers</code>，其余与上面那份相同。
Claude Code（命令行）
claude mcp add --transport stdio jackjin1997-markindex -- npx -p markindex -p
Claude Code 不收 JSON 文件，用这条命令直接加。
配置项的键名以你的客户端为准：客户端与 CLI
- ★ 数取值
- 1 ★ · jackjin1997/markindex · 取自 GitHub 搜索 API · （2026-11-13 20:00:50 核对）
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单（我们从中收集的条目之一） · 条目类型：MCP 服务
- 收录与活跃
- 收录于 2026-11-03 · 最近见到 2026-11-14 · 共见到 12 次 · 被 12 个来源列出
- 评分构成
- 综合分 1,200 · 1 ★ · 12 个来源 · mcp
- 安装
npx -p markindex -p
常见问题（答案都来自我们的记录）
怎么安装？
该仓库给出的安装命令是
npx -p markindex -p。我们的记录里它是仓库自己提供的；不保证在你的客户端上直接可用。它适合谁 / 用来做什么？
我们把它归在这些标签下: MCP 服务。标签来自条目自身，不是我们强加的分类。
谁维护它、还在更新吗？
仓库
jackjin1997/markindex；我们收录于 2026-11-03；最近见到 2026-11-14。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。# MarkIndex
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Vectorless, structure-first retrieval over large libraries of long Markdown documents — for agents.
MarkIndex parses every Markdown file into a tree of its own sections, stores the trees, the original lines and a
mixed Chinese/English BM25 index in one SQLite file, and gives an agent five read-only tools to walk
"library → folder → document → section" and read the original text with line numbers. No embeddings, no vector
database, no chunking guesswork: the document's own structure is the index, and every piece of evidence can be
cited back as [docpath, L - ].
> Inspired by VectifyAI/PageIndex, MarkIndex is an independent,
> unofficial TypeScript implementation focused on Markdown. It is not affiliated with or endorsed by VectifyAI.
中文说明：README.zh-CN.md
## Why
Structure-first, not chunk-first. Long professional documents (filings, guidelines, laws, manuals) are
already organized by their authors. Navigating that outline keeps context intact and makes answers explainable
and citable; arbitrary chunks + vector similarity cut sections apart.
Deterministic and LLM-free indexing. Parsing (mdast, not regex), tree building and the token-cost tree
optimization never call a model; the same input always produces the same tree. LLMs are optional and only used
for node summaries, document descriptions and the built-in retrieve() loop.
Markdown done properly. Setext headings, preface text before the first heading, documents without any
heading, front matter, # inside code fences, skipped heading levels, BOM / CRLF — every source line belongs to
exactly one node, and oversized sections are split at block boundaries into chunk nodes.
Keyword fallback that works for Chinese. BM25 over Intl.Segmenter word segmentation (Chinese, English and
mixed text, identifiers like C++, ISO-27001, v2.1), plus a trigram substring index as a second pass.
Budgeted tool responses. Tools never throw; they return JSON envelopes with nextsteps guidance and stay
under a 95 000-character budget, paginating large outlines and sections.
## Install
bash
npm install markindex # library + CLI (Node.js >= 22.12)
npx markindex --help
From source:
bash
git clone https://github.com/jackjin1997/markindex.git && cd markindex
npm install && npm run build
node dist/cli.js --help # or npm link to get a markindex command
Optional, only for LLM features (summaries, retrieve(), agent-mode evaluation): install the
AI SDK provider you want, e.g. npm install @ai-sdk/anthropic, and set its API key
(ANTHROPICAPIKEY, …). With npx and no local install, put the provider in the same temporary environment:
bash
npx -p markindex -p @ai-sdk/anthropic markindex index ./docs --summary-model anthropic:claude-sonnet-5-5
## CLI
bash
# Build or incrementally update the index (stored in /.markindex/index.db)
markindex index ./docs
markindex index ./docs --summary-model anthropic:claude-sonnet-5-5 --estimate # cost estimate, no LLM calls
markindex index ./docs --summary-model anthropic:claude-sonnet-5-5 # with node summaries
markindex index ./docs --summary-model anthropic:claude-sonnet-5-5 --summary-rpm 50 --summary-tpm 40000 # rate-limited
markindex index ./docs --json # machine-readable report
MarkIndex parses every Markdown file into a tree of its own sections, stores the trees, the original lines and a
mixed Chinese/English BM25 index in one SQLite file, and gives an agent five read-only tools to walk
"library → folder → document → section" and read the original text with line numbers. No embeddings, no vector
database, no chunking guesswork: the document's own structure is the index, and every piece of evidence can be
cited back as [docpath, L - ].
> Inspired by VectifyAI/PageIndex, MarkIndex is an independent,
> unofficial TypeScript implementation focused on Markdown. It is not affiliated with or endorsed by VectifyAI.
中文说明：README.zh-CN.md
## Why
Structure-first, not chunk-first. Long professional documents (filings, guidelines, laws, manuals) are
already organized by their authors. Navigating that outline keeps context intact and makes answers explainable
and citable; arbitrary chunks + vector similarity cut sections apart.
Deterministic and LLM-free indexing. Parsing (mdast, not regex), tree building and the token-cost tree
optimization never call a model; the same input always produces the same tree. LLMs are optional and only used
for node summaries, document descriptions and the built-in retrieve() loop.
Markdown done properly. Setext headings, preface text before the first heading, documents without any
heading, front matter, # inside code fences, skipped heading levels, BOM / CRLF — every source line belongs to
exactly one node, and oversized sections are split at block boundaries into chunk nodes.
Keyword fallback that works for Chinese. BM25 over Intl.Segmenter word segmentation (Chinese, English and
mixed text, identifiers like C++, ISO-27001, v2.1), plus a trigram substring index as a second pass.
Budgeted tool responses. Tools never throw; they return JSON envelopes with nextsteps guidance and stay
under a 95 000-character budget, paginating large outlines and sections.
## Install
bash
npm install markindex # library + CLI (Node.js >= 22.12)
npx markindex --help
From source:
bash
git clone https://github.com/jackjin1997/markindex.git && cd markindex
npm install && npm run build
node dist/cli.js --help # or npm link to get a markindex command
Optional, only for LLM features (summaries, retrieve(), agent-mode evaluation): install the
AI SDK provider you want, e.g. npm install @ai-sdk/anthropic, and set its API key
(ANTHROPICAPIKEY, …). With npx and no local install, put the provider in the same temporary environment:
bash
npx -p markindex -p @ai-sdk/anthropic markindex index ./docs --summary-model anthropic:claude-sonnet-5-5
## CLI
bash
# Build or incrementally update the index (stored in /.markindex/index.db)
markindex index ./docs
markindex index ./docs --summary-model anthropic:claude-sonnet-5-5 --estimate # cost estimate, no LLM calls
markindex index ./docs --summary-model anthropic:claude-sonnet-5-5 # with node summaries
markindex index ./docs --summary-model anthropic:claude-sonnet-5-5 --summary-rpm 50 --summary-tpm 40000 # rate-limited
markindex index ./docs --json # machine-readable report
收录徽章（可选）
想把收录标记放进 README 就复制这行，可选，不影响收录。
[](https://anclum.com/zh/s/jackjin1997-markindex/)
- 来源
- awesome · https://github.com/jackjin1997/markindex
- 按领域浏览
- MCP 服务
- Traction
- 1 ★
- 收录来源
- 12 个独立来源
- 收录于
- 今天
同类推荐
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。