内容
<div align="center">
<img src="assets/logo.png" alt="项目logo" width="200"/>
<h1>本地存储 MCP</h1>
<p><em>您的数据，本地存储</em></p>
</div>
## 演示视频
https://github.com/user-attachments/assets/4b8f11cd-bb9f-4822-b241-60ecd60bf39f
## 特性
- ✅ **智能存储**：自动生成标题和标签
- 🔍 **强大的搜索**：支持模糊搜索和标签过滤
- 🏷️ **智能标签**：基于内容的AI建议标签
- 📊 **统计信息**：知识库使用统计
- 💾 **安全存储**：数据存储在用户主目录中
- 🔒 **线程安全**：支持并发访问
## 项目结构
```
knowledge_vault/
├── __init__.py # 包初始化
├── server.py # FastMCP 服务器主文件
├── storage.py # 知识存储模块
└── search.py # 搜索功能模块
pyproject.toml # 项目配置
start_server_new.py # 启动脚本
```
## 安装
### 使用 uv 安装依赖
```bash
# 如果尚未安装 uv，请安装
curl -LsSf https://astral.sh/uv/install.sh | sh
# 同步依赖
uv sync
```
### 配置 Claude Desktop
编辑 `~/.config/claude_desktop_config.json`：
```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": "本地知识管理 MCP 服务器"
}
}
}
```
### 重启 Claude Desktop
在配置后重启 Claude Desktop。
## 使用
### 存储知识
```
存储一个编程技巧：使用 Python 列表推导使代码更简洁
```
### 搜索知识
```
搜索 Python 知识
```
### 查看统计信息
```
显示知识库统计信息
```
## 可用工具
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+**：运行环境
MCP 市场
