library-mcp

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，依次选择 Setting、Developer，并让它创建 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. 应该就能用了……