# markdown-vault-mcp

> Generic markdown collection MCP server with FTS5 + semantic search, frontmatter-aware indexing, and incremental reindexing

- **URL**: https://www.freshcrate.ai/projects/markdown-vault-mcp
- **Author**: pvliesdonk
- **Category**: MCP Servers
- **Latest version**: `v1.28.0` (2026-05-03)
- **License**: MIT
- **Source**: https://github.com/pvliesdonk/markdown-vault-mcp
- **Homepage**: https://pvliesdonk.github.io/markdown-vault-mcp/
- **Language**: Python
- **GitHub**: 5 stars, 3 forks
- **Registry**: github (`pvliesdonk/markdown-vault-mcp`)
- **Tags**: `claude`, `embeddings`, `fastmcp`, `fts5`, `knowledge-base`, `markdown`, `mcp`, `mcp-server`, `python`

## Description

Generic markdown collection MCP server with FTS5 + semantic search, frontmatter-aware indexing, and incremental reindexing

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.28.0` | 2026-05-03 | High | ## v1.28.0 (2026-05-03)  _This release is published under the MIT License._  ### Bug Fixes  - Address gemini findings on legacy chunker behaviour and tokenization ([`ebec934`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/ebec934ab81f8afcf6c020cc9140d48f2b6a06e5))  - **scanner**: Revert _SHORT_DOC_LINES to 30 and unconditional bypass ([`937bb3a`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/937bb3a8d8d2c7ed4d76a2dc8f8c103de7f96828))  - **search**: Symmetric query/content tok |
| `v1.27.1` | 2026-04-23 | High | ## v1.27.1 (2026-04-23)  _This release is published under the MIT License._  ### Bug Fixes  - **ci**: Docs deploy on v* tag push + 3-part concurrency ([`6987252`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/698725213e04c6ca07e2702ff89902b5d947e4cc))  - **ci**: Stage conflict markers before git checkout -B in copier-update ([`e2c3654`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/e2c365468ac4c5b51b56f1098b2b3b007f8aabc9))  - **ci**: Stage conflict markers before git checkou |
| `v1.27.0` | 2026-04-21 | High | ## v1.27.0 (2026-04-21)  _This release is published under the MIT License._  ---  **Detailed Changes**: [v1.26.0-rc.1...v1.27.0](https://github.com/pvliesdonk/markdown-vault-mcp/compare/v1.26.0-rc.1...v1.27.0) |
| `v1.26.0-rc.1` | 2026-04-21 | High | ## v1.26.0-rc.1 (2026-04-21)  _This release is published under the MIT License._  ### Chores  - Adopt fastmcp-server-template v1.0.0 (#407) ([#407](https://github.com/pvliesdonk/markdown-vault-mcp/pull/407), [`9e9f013`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/9e9f013dffe378b018de598b4d0e77ac87e693f8))  ### Documentation  - **design**: Add Shared Infrastructure section pointing at fastmcp-pvl-core (#404) ([#404](https://github.com/pvliesdonk/markdown-vault-mcp/pull/404), [`9c12739 |
| `v1.25.0` | 2026-04-20 | High | ## v1.25.0 (2026-04-20)  _This release is published under the MIT License._  ---  **Detailed Changes**: [v1.24.0-rc.1...v1.25.0](https://github.com/pvliesdonk/markdown-vault-mcp/compare/v1.24.0-rc.1...v1.25.0) |
| `v1.24.0-rc.1` | 2026-04-20 | High | ## v1.24.0-rc.1 (2026-04-20)  _This release is published under the MIT License._  ### Chores  - Repin fastmcp-pvl-core to >=1.0.0,<2 (stable) (#403) ([#403](https://github.com/pvliesdonk/markdown-vault-mcp/pull/403), [`830f882`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/830f8828d49d7e76da38ae8ef02154b00d15b662))  ### Refactoring  - **artifacts**: Adopt core ArtifactStore with eager bytes (MV-PR5) (#400) ([#400](https://github.com/pvliesdonk/markdown-vault-mcp/pull/400), [`0a8e01f`] |
| `v1.23.1` | 2026-04-20 | High | ## v1.23.1 (2026-04-20)  _This release is published under the MIT License._  ---  **Detailed Changes**: [v1.23.2-rc.1...v1.23.1](https://github.com/pvliesdonk/markdown-vault-mcp/compare/v1.23.2-rc.1...v1.23.1) |
| `v1.23.2-rc.1` | 2026-04-20 | High | ## v1.23.2-rc.1 (2026-04-20)  _This release is published under the MIT License._  ### Testing  - Accept PSR prerelease version format in mcpb packaging tests (#395) ([#395](https://github.com/pvliesdonk/markdown-vault-mcp/pull/395), [`132fc92`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/132fc92cdeaff4c1bb14bcaa6f65d03434dbc0ab))  ---  **Detailed Changes**: [v1.23.1-rc.1...v1.23.2-rc.1](https://github.com/pvliesdonk/markdown-vault-mcp/compare/v1.23.1-rc.1...v1.23.2-rc.1) |
| `v1.23.1-rc.1` | 2026-04-19 | High | ## v1.23.1-rc.1 (2026-04-19)  _This release is published under the MIT License._  ### Bug Fixes  - Rewrite bump_manifests as Python for PSR Docker container (#394) ([#394](https://github.com/pvliesdonk/markdown-vault-mcp/pull/394), [`a23b571`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/a23b571fbb78768b3f7e9d6eee6c02b8b6feb9ee))  ### Continuous Integration  - Docs workflow checks out main on release to avoid tag-moved race (#391) ([#391](https://github.com/pvliesdonk/markdown-vault-m |
| `v1.23.0` | 2026-04-19 | High | ## v1.23.0 (2026-04-19)  _This release is published under the MIT License._  ### Bug Fixes  - Increase uvicorn graceful shutdown timeout to 3s ([`59a4f98`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/59a4f98a7d4992adbdd72173360334c592769a12))  - Packaging script bugs from scholar-mcp cross-review ([`da26c59`](https://github.com/pvliesdonk/markdown-vault-mcp/commit/da26c591b233861f6390a6dbb183100ee2f5613e))  - **ci**: Fix marketplace.json path in publish-claude-plugin-pr ([`cbbb286`]( |

## Citation

- HTML: https://www.freshcrate.ai/projects/markdown-vault-mcp
- Markdown: https://www.freshcrate.ai/projects/markdown-vault-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/markdown-vault-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._