Markdown知识库管理服务

一个用于管理和交互Markdown知识库的MCP服务器,支持按标签、文本、日期范围检索内容,适用于个人知识管理和内容检索。

  • by lethain
  • Python
  • 本地部署
  • 91 星标
  • 更新于
在 GitHub 查看 lethain/library-mcp

使用说明

图书馆mcp 是用于与进行交互的MCP服务器 Markdown知识库。基本上,文件夹可能有也可能没有子文件夹,包括 文件与 .md 扩展并从元数据开始,如:

----
title: My blog post
tags:
- python
- programming
url: /my-blog-post
---

# My blog post
Yesterday I was dreaming about...

当前版本中的典型工作流程是 检索给定标签的最新内容,然后 讨论使用该标签:

Get the next 50 posts with tag "executive",
then tell me what I should do about this problem
I am running into: ...

您也可以按日期范围执行相同的操作:

Summarize the blog posts I wrote in the past year.

你可能会合理地问“为什么不上传你的整个博客 进入上下文窗口?“这个图书馆有两个地方 优于该方法:

  1. 我的博客语料库比今天大多数模型的上下文窗口大得多。 此外,即使上下文窗口变得非常大,我也写了很多 过去平庸的东西,所以省略它可能是一个特点。
  2. 我有很多不同的Markdown知识库,这让我 在它们之间协同操作。

最后,这是一个爱好项目,旨在在您的本地运行 笔记本电脑。使用该软件没有人受到伤害,但确实如此 工作得很好!

工具

此MCP服务器公开了这些工具。

内容搜索工具

用于在上下文窗口中检索内容的工具:

  • get_by_tag -按标签检索内容
  • get_by_text -在内容中搜索特定文本
  • get_by_slug_or_url -通过slug或URL查找帖子
  • get_by_date_range -获取在日期范围内发布的帖子

标签管理工具

用于导航知识库的工具:

  • search_tags -搜索与查询匹配的标签
  • list_all_tags -列出按帖子数量和最近度排序的所有标签

维护工具

处理运行工具的工具:

  • rebuild -重建内容索引, 如果您添加了更多内容,则很有用, 编辑现有内容等

设置/安装

这些说明描述了以下设备的安装 克劳德桌面 在OS X上。 它应该在其他平台上同样工作。

  1. 安装 克劳德桌面.

  2. 克隆 图书馆mcp 进入 我想是个方便的地方 /Users/will/library-mcp

  3. 确保你有 uv 安装后,您可以 遵循以下说明

  4. 转到Cladue桌面、设置、开发人员,让它创建您的MCP配置文件。 然后你想更新你的 claude_desktop_config.json. (请注意,您应该替换 will 与您的用户,例如输出 whoami.

     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"
           ]
         }
       }
     }
    
  5. 关闭克劳德并重新打开它。

  6. 它应该工作。。。