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:
- 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
This MCP server exposes these tools.
Content Search 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 range
Tag Management Tools
Tools for navigating your knowledge base:
search_tags- Searches for tags matching a querylist_all_tags- Lists all tags sorted by post count and recency
Maintenance Tools
Tools for dealing with running the tool:
rebuild- Rebuilds the content index, useful if you have added more content, edited existing content, etc
Setup / Installation
These 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
uvinstalled, 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 replacewillwith your user, e.g. the output ofwhoami.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...
Metadata
Release files for iflow-mcp_library-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_library_mcp-0.1.0.tar.gz | 7.5 kB | Without provenance | Details for iflow_mcp_library_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_library_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_library_mcp-0.1.0-py3-none-any.whl |
Total release size: 15.4 kB
Release files / iflow_mcp_library_mcp-0.1.0.tar.gz
| Download URL | iflow_mcp_library_mcp-0.1.0.tar.gz |
|---|---|
| Size | 7.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7845adab3c4e28b042101ef08c1f84f1cab08fb7b387e6e627d5e10abd9ecd23
|
|
BLAKE2b-256 checksum How to use checksums |
0cd1e479d59fd3679384c9c4f176e3dd8223185cf3f727f4f4fa5cf9312a9420
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.9
|
Release files / iflow_mcp_library_mcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_library_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e99a77a83b4fe3194c1f7b2de7ff32b55e4462690f06b2b82a254b8be4a328e0
|
|
BLAKE2b-256 checksum How to use checksums |
ed36818a72340d2bd93acaf90c03019c7e3bd255f253ed1363783b2d377f1726
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.9
|
Security for iflow-mcp_library-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.