Skip to content

v0.1.0 — initial public release

Choose a tag to compare

@LEnc95 LEnc95 released this 17 Aug 00:22
· 10 commits to main since this 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-mcp

Tools

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.