
MCP server for operating on Markdown knowledge bases
MCP server for operating on Markdown knowledge bases
·
library-mcp is an MCP server for interacting with
Markdown knowledge bases. Basically, folders that may or may not have subfolders, that include
files with .md extension and start with metadata like:
----
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:
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!
This MCP server exposes these tools.
Tools for retrieving content into your context window:
get_by_tag - Retrieves content by tagget_by_text - Searches content for specific textget_by_slug_or_url - Finds posts by slug or URLget_by_date_range - Gets posts published within a date rangeTools for navigating your knowledge base:
search_tags - Searches for tags matching a querylist_all_tags - Lists all tags sorted by post count and recencyTools for dealing with running the tool:
rebuild - Rebuilds the content index,
useful if you have added more content,
edited existing content, etcThese instructions describe installation for Claude Desktop on OS X. It should work similarly on other platforms.
Install Claude Desktop.
Clone library-mcp into
a convenient location, I'm assuming /Users/will/library-mcp
Make sure you have uv installed, you can follow these instructions
Go to Cladue Desktop, Setting, Developer, and have it create your MCP config file.
Then you want to update your claude_desktop_config.json.
(Note that you should replace will with your user, e.g. the output of whoami.
cd /Users/will/Library/Application Support/Claude
vi claude_desktop_config.jsonThen add this section:
{
"mcpServers": {
"library": {
"command": "uv",
"args": [
"--directory",
"/Users/will/library-mcp",
"run",
"main.py",
"/Users/will/irrational_hugo/content"
]
}
}
}Close Claude and reopen it.
It should work...
This repo does not document an install step we could read. Check the README on GitHub.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/tools to learn what the "Tools" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/tools)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "tools" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.