关于 aichivist
aichivist 是面向文档整理的本地 MCP 服务，适合希望按归档规则管理文件的用户。它会先生成可审阅的重命名、分类和去重计划，并记录可撤销的操作。
主要功能
- 01变更前审阅和编辑计划
- 02重命名并分类文档
- 03按内容查找重复文件
- 04撤销已记录的操作
- 05检查存储并生成目录
适用场景
- 01借助 AI 整理下载文件夹
- 02在删除前审阅重复文件
- 03不改动文件地检查存储
MCP 相关
aichivist 向 MCP 客户端提供文件整理能力。AI 只能操作获准访问的文件夹，且执行步骤前须经批准。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
为什么不直接问 AI？
告诉 ChatGPT 或 Claude “整理一下我的文档”，通常只会得到一个仓促的结果：按文件类型分类的文件夹
（PDFs、Images、Misc）、依旧晦涩的文件名、重复文件原地不动——有时还会因为文件被移动，导致游戏或程序无法启动。所有操作一气呵成，没有计划供你检查，也无法撤销。下次，AI 又会另创一套整理方式。
aichivist 为你的 AI 提供专业档案管理员使用的工具：你自己的归档规则、由你批准的计划、从文档本身读取的名称、按内容查找重复文件、确保程序继续正常运行，以及可撤销的每一步操作记录。已在实际场景中用于整理 25,000 张照片和 1,500 份文档。
工作原理
- 未经你同意，绝不执行操作。 你会先看到计划，可以修改或删除其中任何一项。
- 绝不会丢失文件。 每一步操作都会记录并可撤销；只有在你同意后，重复文件才会被移至回收站。
- 文件始终由你掌控。 使用普通文件夹和你自己的云服务，无需账号或服务器。
- 支持你的语言。 消息支持英语和德语；规则模板支持英语、德语、法语、意大利语和西班牙语。
功能介绍
开始使用
Claude Desktop —— 最简单的方式，无需技术知识
- 从最新版本下载
.mcpb文件 （还没有 Claude Desktop？请访问 claude.ai/download）。 - 双击文件，然后选择允许 Claude 整理的文件夹。
- 对 Claude 说：“整理一下我的下载文件夹。”
其他方式：Claude Code、Codex/Gemini CLI/Cursor，或不使用 AI
Claude Code —— 输入 /plugin marketplace add luftphilipp/aichivist，然后输入 /plugin install aichivist@aichivist，
接着说 “设置 aichivist。” 如果缺少命令行工具，设置过程会安装它（安装前会征求同意）。
Codex、Gemini CLI、Cursor —— 运行 pipx install aichivist（或 uv tool install aichivist），然后将
templates/AGENTS.md 复制到 Agent 读取指令的位置。
下载了 ZIP？ 解压后，双击 Start (Mac).command 或 Start (Windows).bat
（Linux：start.sh）。系统会打开一个简易菜单——查看你的下载文件夹、检查备份，并了解电脑上哪些 AI 应用可以帮你整理文件。无需安装，只需 Python 3（新款 Mac 会自动提示安装）。
首次运行时，电脑会发出警告，因为文件来自互联网：
- **Mac：**点击 完成，打开 系统设置 → 隐私与安全性，向下滚动并点击 “Start (Mac).command” 旁边的 仍要打开，然后确认。
- **Windows：**点击 更多信息 → 仍要运行。
只是想了解一下？ 查看文件夹中的情况——不使用 AI，也不会更改任何内容：
pipx install aichivist
aichivist survey ~/Downloads
它会显示文件数量、占用空间的重复文件、名称毫无意义的文件、会拖慢云端同步的文件夹、应当避免操作的程序文件夹，以及硬盘是否健康。aichivist storage storage.md
会检查备份是否安全，以及每年的存储成本（首次运行时会显示表格格式）。
aichivist catalog-page <folder> --open 会将目录转换为可搜索的页面，aichivist photos 会按年份整理照片，而 aichivist watch ~/Downloads --install 会在文件累积到 25 个时提醒你。
查看实际效果（终端演示）
源自真实的档案实践
档案馆数百年来一直可靠地整理文档。aichivist 将这些规则带到你的电脑上：
| 在档案馆中 | 在 aichivist 中 |
|---|---|
| 归档方案规定所有内容的存放位置 | 你的规则规定各类文档的存放位置——AI 会遵循这些规则 |
| 未经决定，不会丢弃任何东西 | 只有在你同意后，才会删除重复文件和旧文件 |
| 每份文档都会在目录中注明信息 | 每个文件夹都会生成一份内容清单，方便你日后查找 |
| 已整理完成的馆藏会封存 | 已整理完成的文件夹（例如去年的税务文件）会被锁定、检查并设为可搜索 |
| 记录会保存一段指定时间，之后归档或销毁 | 旧记录到期后会提示你——由你决定 |
| 副本会保存在不同地点 | 它会检查 3-2-1 规则：3 份副本、2 种存储介质、1 份异地保存 |
隐私
aichivist 本身只在你的电脑上运行。读取文档的 AI（例如 Claude）会收到它所读取文档的内容——因此，你可以决定允许它打开哪些文件夹，也可以完全排除私人文件夹。
构建过程
aichivist 由Philipp Luft设计。他是一名受过专业培训的档案管理员和信息专业人员（Fachmann Information & Dokumentation），目前正在学习 Business AI，负责引入档案原则并确定需求。代码由 Claude Code 编写——每次提交都会将 Claude 列为共同作者。
更多
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。