M

MCP库

@lethain/library-mcp
0 Stars 19 次浏览 lethain 更新于 2026-08-23

一个MCP服务器,它 enables 与Markdown知识库的交互,允许用户通过标签、文本、URL或日期范围从本地markdown文件中搜索和检索内容。

该服务暂未提供标准配置,请参考 README 手动接入

服务介绍

library-mcp 是一个用于与 Markdown 知识库交互的 MCP 服务器。基本上,这些文件夹可能包含或不包含子文件夹,并且包括扩展名为 .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 上安装 Claude Desktop 的步骤。在其他平台上应该类似适用。

  1. 安装 Claude Desktop

  2. library-mcp 克隆到一个方便的位置,假设为 /Users/will/library-mcp

  3. 确保已安装 uv,你可以 按照这些说明进行操作

  4. 打开 Claude Desktop,进入设置 -> 开发者,并让它创建你的 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. 关闭 Claude 并重新打开它。

  6. 应该可以正常工作...