Mortis-RAG-MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VAULT_MCP_CONFIG | No | Path to a TOML configuration file. Overrides the default config path (~/.vault_mcp/config.toml), but is superseded by the --app-config command-line argument. | |
| VAULT_MCP_API_KEY | No | API key used for external embedding and reranking providers. Referenced via ${VAULT_MCP_API_KEY} in the configuration file. | |
| VAULT_MCP_REGISTRY | No | Path to the vault registry file. Normally set automatically, but can be overridden for testing or multi-instance setups. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kb_initA | 注册（初始化）一个文件夹为知识库：校验目录、写入用户级注册表（跨重启保留）、后台建立索引并启动文件监听。首次使用或要纳入新文件夹时调用。 |
| kb_unregisterA | 注销一个已注册的知识库：停止文件监听并从注册表移除（不影响文件夹本身）。 |
| kb_vaultsA | 列出所有已注册的知识库（含存活状态与索引进度）。 |
| kb_set_weightA | 设置知识库的检索权重：跨库检索时该库所有 chunk 的分数会乘以该系数，用于表达"这个库更重要"（默认 1.0，取值 0 < w <= 100）。 |
| kb_exportA | 把知识库的索引快照（chunks + 向量 + FTS）导出为 zip 文件，用于换机/换目录迁移，导入后无需全量重新 embedding。要求缓存已启用且完成过至少一次索引。 |
| kb_importA | 从 kb_export 生成的快照恢复索引缓存（先 kb_init 注册目标目录再调用）。导入后的下一次同步应当 0 次 embedding 调用；快照的向量模型/维度与本机配置不一致时拒绝，除非 force=true（此时只导入文本层并本地重嵌）。 |
| kb_rebuildA | 删除指定知识库的磁盘缓存并强制全量重建索引（首次建库或内容大改后用）。 |
| kb_listB | 列出已索引的 Markdown 文件。可传 vault_path 指定知识库。 |
| kb_searchA | 搜索知识库并返回结构化原始 chunks。不传 vault_path 时跨全部注册库 fan-out 检索（结果带 vault 字段）。 |
| kb_readA | 读取知识库原文（不调用 LLM 生成回答；若索引有未同步的变更会先触发一次增量同步，可能调用 embedding API，建议带上 start_line/end_line 限定范围避免一次拉全篇）。多库环境下建议显式传 vault_path（fan-out 结果中的 source 是库内相对路径）。 |
| kb_statsB | 返回指定知识库的索引状态、失败文件、最后同步时间和模型信息。 |
| kb_exemptA | 查看、添加、删除知识库的 RAG 豁免项（排除不希望被检索的私密/草稿内容）。支持查看规则、添加/删除 .vaultignore 通配符、标记/取消单个文件豁免、检查文件豁免状态。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Each tool targets a distinct operation in the RAG knowledge-base lifecycle: init/unregister manage registration, export/import handle snapshots, search/read retrieve content, and stats/vaults/exempt cover status and filtering. Even similar actions like rebuild and import are clearly separated by purpose and described preconditions.
Tools consistently use a kb_ prefix and short snake_case names, with clear verb-style commands like kb_init, kb_search, and kb_export. Minor deviations exist: kb_vaults and kb_stats are noun-style rather than verb-based, and kb_exempt covers multiple exemption-related actions rather than a single operation.
The 12 tools are well-scoped for a RAG knowledge-base management server, covering registration, indexing, migration, search, reading, statistics, weighting, and exemptions. Each tool serves a distinct and necessary role without bloat or redundancy.
The tool surface covers the core lifecycle well: registering, listing, searching, reading, exporting/importing, rebuilding, unregistering, and managing exemptions are all present. A minor gap is the lack of an explicit manual sync command, though file watching and read-triggered incremental sync largely mitigate this.