个人文件管理服务器

个人文件MCP服务器

用于管理和搜索个人文件的模型上下文协议（MCP）服务器。

特性

• 文件扫描：将文件递归索引到本地SQLite数据库中。
• 搜索：按名称快速搜索文件。
• 元数据：提取基本文件统计数据（大小、日期），并允许AI生成描述。
• 人工智能集成：可选切换，使用AI模型生成文件摘要和标签。

设置

1. 环境: 该项目使用虚拟环境 venv.运行前激活它：

   • 窗户： .\venv\Scripts\activate
   • Linux/Mac： source venv/bin/activate

2. 安装依赖项:

   复制

   pip install -r requirements.txt
   

3. 环境变量 （可选）： 创建一个 .env 文件或设置变量：

   • AI_ENABLED=true （启用AI功能）
   • AI_MODEL=llama3 （或您喜欢的型号）

用法

运行服务器

python main.py

工具

• scan_files(path)：为目录建立索引。
• search_files(query)：搜索文件。
• get_file_metadata(path)：获取详细信息。
• generate_ai_metadata(path)：生成AI描述（需要启用AI）。

配置

数据库存储在 files.db 在同一个目录中。