项目介绍

library-mcp 是一个用于与Markdown知识库交互的MCP服务器。基本上，它是一个包含或不包含子文件夹的文件夹，其中包含以.md扩展名开头的文件，并且开始于类似以下元数据：

----
title: 我的博客文章
tags:
- python
- 编程
url: /my-blog-post
---

# 我的博客文章
昨晚我梦到了...

当前版本中的典型工作流程是：

• 使用特定标签获取最近的50篇内容，然后讨论如何处理这个问题：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. 它应该可以正常工作...