使用说明
PIFRS🧠 | 个人智能文件检索系统
PIFRS 是macOS优化的自定义 模型上下文协议（MCP） 服务器被构建为个人文件助理。它侧重于使用基于时间戳、名称和内容的搜索进行快速、安全的文件发现和工作空间分析。
示例：授予Claude使用PIFRS工具查找最近的.ipynb文件的权限。
为什么选择PIFRS？
标准的AI文件访问通常很慢，或者有“幻觉”文件路径的风险。PIFRS通过实施以下措施解决了这个问题：
- 广度优先搜索（BFS）： 深度限制扫描，防止系统深度滞后。
- 系统意识： 自动跳过
.git,node_modules，以及Library文件夹。 - 安全第一： 严格的10MB限制和MIME类型检查，以防止LLM阻塞二进制数据。
- 演出 用途
@lru_cache用于路径验证和迭代搜索以提高内存效率。
功能集
1.情报与分析
PIFRS不仅仅是“查找”文件；它了解你的工作空间。
- 工作区概述： 总结总大小、文件计数和扩展名细分。
- 太空猪： 识别最大/最旧的文件，以帮助您回收存储空间。
- 智能组织器： 根据文件类型建议目录结构。
2.强大的搜索和检索功能
- 类似Grep的内容搜索： 按扩展、不区分大小写和深度过滤。
- 最近的活动： 快速找到你在过去一个小时或一天里做了什么。
- 安全阅读： 具有大小保护和行限制的结构化JSON输出。
“工作区概述”工具正在运行，它细分了语言使用和文件数量。
📊 视觉洞察
PIFRS提供数据；AI提供了洞察力。下面是一个例子 太空猪 识别大文件（如旧文件）的工具 .mp4 和 .zip 存档），可以安全删除。
技术栈
- 语言： Python 3.x
- 框架：
fastmcp - 图书馆：
pathlib（现代路径处理），mimetypes,functools.lru_cache - 集成： 适用于任何兼容MCP的客户端（Claude Desktop等）
由Siddarth Singaravel开发，专注于构建可扩展的代理AI工作流程。
