Tools

What is Tools?

Tools is an MCP server for interacting with Markdown knowledge bases—folders containing .md files with YAML metadata (title, tags, url). It exposes tools to retrieve content by tag, text, slug/URL, or date range, and to manage tags. It is intended for users with large collections of Markdown files that exceed typical context windows or span multiple knowledge bases.

How to use Tools?

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.

Key features of Tools

• 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

Use cases of Tools

• Quickly retrieve recent posts on a specific tag for context
• Search your knowledge base for posts containing a particular phrase
• Summarize blog posts written in a given year by date range
• Navigate across multiple Markdown knowledge bases simultaneously
• Rebuild the search index after adding or editing content

FAQ from Tools

Why not just upload the entire blog into the context window?

Tools is better when your corpus is much larger than typical context windows, or when you have multiple distinct knowledge bases you want to operate across together.

What runtime does Tools require?

Tools requires Python and uv. It is installed by cloning the repository and configuring Claude Desktop to run main.py via uv.

Where does the data live?

All data lives in local Markdown files on your filesystem. Tools reads from the directory you specify in the configuration.

Is there any authentication or remote transport?

No. Tools is a hobby project intended for running locally on your laptop; no authentication or network transport is used.

How do I update the content index after adding or modifying files?

Use the rebuild tool to re-scan the content directory and refresh the index.