Tools
About
A local server to query and interact with Markdown knowledge bases by tags, text, slug, or date.
Details
- Author
- lethain
- GitHub stars
- 90
- Downloads
- 235
- Categories
- Database, Knowledge Base, Other, Search, Developer Tools
Jump to
- Retrieve content by tag with get_by_tag
- Search content by text with get_by_text
- Find posts by slug or URL with get_by_slug_or_url
- Get posts within a date range with get_by_date_range
- Search and list all tags with search_tags and list_all_tags
- Rebuild the content index with rebuild
Clone the library-mcp repository, ensure uv is installed, then configure Claude Desktop by editing claude_desktop_config.json to point uv at main.py with a directory of Markdown content. After restarting Claude, you can invoke tools like get_by_tag or get_by_date_range through natural language queries.
---- title: My blog post tags: - python - programming url: /my-blog-post --- # My blog post Yesterday I was dreaming about...
The typical workflow in the current verison is to retrieve recent content for a given tag, and then discuss using that tag:
Get the next 50 posts with tag "executive", then tell me what I should do about this problem I am running into: ...
You can also do the same but by date ranges:
Summarize the blog posts I wrote in the past year.
You might reasonably ask "why not just upload your entire blog into the context window?" and there are two places where this library outperforms that approach:
- My blog corpus is much larger than most model's context windows today. Further, even if the context windows became exhaustively large, I wrote a lot of mediocre stuff in the past, so maybe omitting it's a feature.
- I have a number of distinct Markdown knowledge bases, and this lets me operate across them in tandem.
Finally, this is a hobby project, intended for running locally on your laptop. No humans have been harmed using this software, but it does work pretty well!
Tools for retrieving content into your context window:
- get_by_tag- Retrieves content by tag
- get_by_text- Searches content for specific text
- get_by_slug_or_url- Finds posts by slug or URL
- get_by_date_range- Gets posts published within a date range
Tools for navigating your knowledge base:
- search_tags- Searches for tags matching a query
- list_all_tags- Lists all tags sorted by post count and recency
Tools for dealing with running the tool:
- rebuild- Rebuilds the content index, useful if you have added more content, edited existing content, etc
These instructions describe installation forClaude Desktopon OS X. It should work similarly on other platforms.
Clonelibrary-mcpinto a convenient location, I'm assuming/Users/will/library-mcp
Make sure you haveuvinstalled, you canfollow these instructions
Go to Cladue Desktop, Setting, Developer, and have it create your MCP config file. Then you want to update yourclaude_desktop_config.json. (Note that you should replacewillwith your user, e.g. the output ofwhoami.
cd /Users/will/Library/Application Support/Claude vi claude_desktop_config.json
{ "mcpServers": { "library": { "command": "uv", "args": [ "--directory", "/Users/will/library-mcp", "run", "main.py", "/Users/will/irrational_hugo/content" ] } } }
Self-maintaining knowledge vault: figure-level search, auto-wikilinks, and sleep-based memory compression.
Production-ready RAG out of the box to search and retrieve data from your own documents.
Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.
MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.
Codicil indexes a repo's Markdown/YAML/TOML docs into a local Chroma store and exposes query_docs/reindex_docs over MCP. Uses Ollama embeddings when available; with zero infra beyond that, it degrades to live keyword search off disk instead of failing.
An MCP server for document ingestion, chunking, semantic search, and note management.
Creates a personal, always-current knowledge base for AI by indexing documentation from websites, GitHub, npm, PyPI, and local files.
Local RAG system for Claude Code with hybrid search (semantic + BM25), cross-encoder reranking, markdown-aware chunking, 9 file formats, file watcher, and 12 MCP tools. Zero external servers. pip install knowledge-rag
Semantic search and RAG over Apple Notes with on-device embeddings, full CRUD, folder management, and fuzzy title matching. 10 tools. Fully local on macOS.
A server for document management and semantic search using AI embeddings, with local JSON storage.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
