返回市场
库-MCP

库-MCP

作者:lethain81 星标更新:2025-04-21

项目介绍

【技术文档摘要】

library-mcp 是一个用于与Markdown知识库交互的MCP服务器。基本上,文件夹可能包含子文件夹,并且这些文件夹中包括扩展名为.md的文件,这些文件以元数据开始,例如:

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

# 我的博客文章
昨天我梦见了……

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

获取带有“高管”标签的接下来50篇文章,
然后告诉我关于我遇到的问题我应该做什么:
...

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

概述我在过去一年写的博客文章。

您可能会合理地问:“为什么不把整个博客上传到上下文窗口中?”这个库在两个方面优于这种做法:

  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. 转到Caldue 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. 应该可以正常工作...