Knowledge_vault

演示视频

https://github.com/user-attachments/assets/4b8f11cd-bb9f-4822-b241-60ecd60bf39f

功能

• ✅ 智能存储：自动生成标题和标签
• 🔍 强大的搜索：支持模糊搜索和标签筛选
• 🏷️ 智能标签：根据内容由 AI 推荐标签
• 📊 统计信息：知识库使用统计
• 💾 安全存储：数据存储在用户主目录中
• 🔒 线程安全：支持并发访问

项目结构

knowledge_vault/
├── __init__.py          # Package initialization
├── server.py            # FastMCP server main file
├── storage.py           # Knowledge storage module
└── search.py            # Search functionality module
pyproject.toml           # Project configuration
start_server_new.py      # Startup script

安装

使用 uv 安装依赖

# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Sync dependencies
uv sync

配置 Claude Desktop

编辑 ~/.config/claude_desktop_config.json：

{
  "mcpServers": {
    "knowledge-vault": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local_store_mcp",
        "run",
        "python",
        "start_server_new.py"
      ],
      "cwd": "/path/to/your/local_store_mcp",
      "description": "Local Knowledge Management MCP Server"
    }
  }
}

重启 Claude Desktop

配置完成后重启 Claude Desktop。

使用方法

存储知识

Store a programming tip: Using Python list comprehension makes code more concise

搜索知识

Search for Python knowledge

查看统计信息

Show knowledge base statistics

可用工具

1. store_knowledge - 存储知识记录
2. search_knowledge - 搜索知识记录
3. list_recent - 查看最近的记录
4. get_knowledge - 根据 ID 获取记录
5. suggest_tags - 推荐标签
6. search_by_tags - 按标签搜索
7. get_stats - 获取统计信息

数据存储

• 位置：~/.knowledge-vault/knowledge.jsonl
• 格式：JSON Lines
• 线程安全：通过文件锁支持并发访问

技术栈

• FastMCP：MCP 服务框架
• Pydantic：数据验证
• uv：现代 Python 包管理工具
• Python 3.10+：运行环境