Tools

基本能力

产品定位

library-mcp 是一个用于管理和检索 Markdown 知识库的工具，特别适合处理大型博客或知识库内容。

核心功能

• 根据标签检索内容 (get_by_tag)
• 根据文本内容搜索 (get_by_text)
• 根据 slug 或 URL 查找文章 (get_by_slug_or_url)
• 根据日期范围获取文章 (get_by_date_range)
• 搜索标签 (search_tags)
• 列出所有标签 (list_all_tags)
• 重建内容索引 (rebuild)

适用场景

• 检索特定标签的内容并进行讨论
• 总结特定时间范围内的博客文章
• 管理和操作多个 Markdown 知识库
• 处理超出模型上下文窗口的大型内容库

工具列表

1. 内容搜索工具
2. get_by_tag: 按标签检索内容
3. get_by_text: 搜索特定文本内容
4. get_by_slug_or_url: 按 slug 或 URL 查找文章

5. get_by_date_range: 获取指定日期范围内的文章

6. 标签管理工具

7. search_tags: 搜索匹配查询的标签

8. list_all_tags: 列出所有标签（按文章数量和最近使用排序）

9. 维护工具

10. rebuild: 重建内容索引（适用于添加或编辑内容后）

常见问题解答

• 为什么不上传整个博客到上下文窗口？
• 博客内容通常远大于当前模型的上下文窗口
• 可以过滤掉过去写的低质量内容
• 支持跨多个知识库操作

使用教程

使用依赖

1. 安装 Claude Desktop
2. 确保已安装 uv（参考 这些说明）

安装教程

1. 克隆 library-mcp 到方便的位置（如 /Users/will/library-mcp）
2. 在 Claude Desktop 的设置中创建 MCP 配置文件
3. 更新 claude_desktop_config.json 文件（位于 /Users/will/Library/Application Support/Claude），添加以下内容（替换 will 为您的用户名）：

{
  "mcpServers": {
    "library": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/will/library-mcp",
        "run",
        "main.py",
        "/Users/will/irrational_hugo/content"
      ]
    }
  }
}

1. 关闭并重新打开 Claude

调试方式

• 确保 uv 已正确安装
• 检查配置文件路径是否正确
• 确认知识库路径（如 /Users/will/irrational_hugo/content）存在且包含 Markdown 文件
• 重启 Claude 应用以应用配置更改

许可证

该项目遵循 None 开源许可条款。