Repository navigation
v0.1.0 — initial public release
Initial public release.
An MCP server for maintaining a markdown knowledge base: classify plans, archive completed docs into a .archiveMD/ recycle bin, and compact noisy files.
Install
claude mcp add --scope user markdown-archive -- npx -y markdown-archive-mcpTools
Five tools over stdio, each taking an absolute root_path so one registration serves any markdown repository.
| Tool | Writes? | Purpose |
|---|---|---|
md_list_repo |
no | List .md files with size, last-touched date, heading count |
md_analyze_plans |
no | Classify as ACTIVE / COMPLETED / STALE / UNKNOWN with evidence |
md_archive_files |
moves | Move explicit paths into .archiveMD/, recording each move |
md_compact_file |
no | Return a compacted version without writing it |
md_update_file |
yes | Write a change and report a diff summary |
It never deletes
Archiving is a move. Collisions get a timestamp suffix rather than an overwrite, every move is appended to a manifest, and scripts/check-no-delete.mjs fails the build if a delete call appears anywhere in src/.
Paths are contained against root_path both lexically and after following symlinks. Archiving takes explicit paths only — never globs — and refuses batches over 25.
Conservative by design
Absence of evidence yields UNKNOWN, never COMPLETED. Conflicting evidence yields low confidence. Age alone never proposes an archive — an early build ignored that and proposed archiving 65 of 67 files in a healthy reference-doc tree.
Full notes in CHANGELOG.md.