aichivist

io.github.luftphilipp由 GitHub 帳號 luftphilipp 發布v0.1.1更新於 Oct 29, 2026

Clean up your files like an archivist: rename, sort, de-duplicate with plans you approve and undo.

已驗證STDIO僅桌面效率與工作流檔案與儲存

概覽

AI 產生的概覽

本機 MCP 伺服器，讓 AI 助理依你自己的歸檔規則重新命名、整理與去重文件，方案需你核准且可復原。

可以做什麼
  • 掃描資料夾，回報檔案數量、浪費空間的重複檔案、無意義命名以及應避開的程式目錄
  • 依你的規則產生重新命名與整理方案，供你核准、修改或刪除其中任一項目
  • 依內容找出重複檔案，經你同意後才移到資源回收筒
  • 記錄每一步操作以便復原，並為每個資料夾產生內容清單
  • 檢查備份與儲存成本、把目錄轉成可搜尋頁面、依年份整理照片、監看資料夾堆積
適用情境
適合想讓助理整理下載、文件或照片資料夾，又不想一次性地、無法回復地亂搬檔案，並希望始終遵循自己的歸檔規則、每一步都能回復的情境。
執行需求
以本機程序在你的電腦上執行（僅桌面端）；MCP 伺服器需要安裝 uv，或使用 Claude Desktop 的封裝擴充功能。透過 root 參數指定允許整理的資料夾。不需帳號、伺服器或 API 金鑰。
安裝前請注意
它會重新命名、移動與刪除檔案，只授權可以接受被整理的資料夾，並在核准前逐項檢查方案。重複檔案需你同意後才進回收筒。讀取文件的 AI 會收到文件內容，應排除私密資料夾。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 aichivist，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[圖片]

aichivist

Clean up your files – like an archivist.

Your AI renames, sorts and de-duplicates your documents.
You approve every step, and everything can be undone.

[tests] [Windows · macOS · Linux] [License: MIT]

[Download for Claude Desktop]

Get started · Why not just ask an AI? · What it can do

Why not just ask an AI?

Tell ChatGPT or Claude "tidy up my documents" and you usually get a quick job: folders by file type (PDFs, Images, Misc), the same cryptic names, duplicates left where they were – and sometimes a game or program that no longer starts because its files were moved. It happens all at once, with no plan to check and no way back. Next time, the AI invents a different system.

[Asking an AI alone vs. an AI with aichivist]

aichivist gives your AI what a professional archivist works with: your own filing rules, a plan you approve, names read from the document itself, duplicates found by content, programs that keep working, and a record of every step that can be undone. Tried in real use on 25,000 photos and 1,500 documents.

How it works

[Demo: "Tidy up my Downloads" – the AI proposes a plan, you approve, the files are filed and the duplicate goes to the trash]

[The AI reads, proposes a plan, you approve, everything is filed]

  • Nothing happens without your OK. You see the plan first and can change or strike any line.
  • Nothing gets lost. Every step is recorded and can be undone; duplicates go to the trash only after you agree.
  • Your files stay yours. Normal folders, your own cloud, no account, no server.
  • Speaks your language. Messages in English or German; rule templates in English, German, French, Italian and Spanish.

What it can do

[Reads scans, names in your style, finds duplicates, programs keep working, seals finished folders, retention periods, backup check, private stays private]

Get started

[Download for Claude Desktop]   [Download ZIP (without AI)]

Claude Desktop – the easiest way, no technical knowledge needed

  1. Click Download for Claude Desktop above (no Claude Desktop yet? claude.ai/download).
  2. Double-click the downloaded file and choose the folders Claude may organize. If Windows asks which app to use, open Claude Desktop instead: Settings → Extensions → Advanced settings → Install Extension… and pick the file.
  3. Ask Claude: "Tidy up my Downloads."
Other ways: Claude Code, Codex/Gemini CLI/Cursor, or without AI

Claude Code – type /plugin install aichivist --marketplace luftphilipp/aichivist, then say "Set up aichivist." The setup installs the command-line tool if it is missing (it asks first).

Codex, Gemini CLI, Cursor – pipx install aichivist (or uv tool install aichivist), then copy templates/AGENTS.md to where your agent reads instructions.

Other AI apps – aichivist's MCP server runs locally with uv installed:

  • Cursor: one-click install (organizes the open project folder).
  • VS Code / GitHub Copilot: one-click install (organizes the open folder).
  • Codex (OpenAI) – add to ~/.codex/config.toml, with the folders it may organize:
    toml
    [mcp_servers.aichivist]command = "uvx"args = ["--from", "aichivist[mcp]", "aichivist", "mcp", "--root", "~/Downloads", "--root", "~/Documents"]
  • Antigravity CLI (Google) – the same server in ~/.gemini/config/mcp_config.json under mcpServers; Gemini CLI (paid plans): gemini extensions install https://github.com/luftphilipp/aichivist.
  • ChatGPT connects only to servers on the internet, not to local ones – aichivist keeps your files on your computer, so it does not offer that. Use Codex instead.

Downloaded the ZIP? Unpack it and double-click Start (Mac).command or Start (Windows).bat (Linux: start.sh). A simple menu opens – look at your Downloads, check your backups, and see which AI app on your computer can tidy up. No installation needed, only Python 3 (a new Mac offers to install it by itself). The first time, your computer warns because the file comes from the internet:

  • Mac: click Done, open System Settings → Privacy & Security, scroll down and click Open Anyway next to "Start (Mac).command", then confirm.
  • Windows: click More info → Run anyway.

Just curious? See what's going on in your folders – no AI, nothing is changed:

bash
pipx install aichivistaichivist survey ~/Downloads

It shows how many files you have, duplicates that waste space, files with meaningless names, folders that slow down your cloud, program folders to leave alone, and whether your hard drive is healthy. aichivist storage storage.md checks whether your backups are safe and what your storage costs per year (it shows the table format on first run). aichivist catalog-page <folder> --open turns your catalogs into a searchable page, aichivist photos sorts photos by year, and aichivist watch ~/Downloads --install reminds you once 25 files have piled up.

See it in action (terminal demo)

[aichivist demo]

Built on real archive practice

Archives have organized documents reliably for centuries. aichivist brings their rules to your computer:

In an archiveIn aichivist
A filing plan says where everything belongsYour rules say which documents go where – the AI follows them
Nothing is thrown away without a decisionDuplicates and old files are only removed after your OK
Every document is described in a catalogEach folder gets a list of what is in it, so you find things later
Finished collections are sealedA completed folder (e.g. last year's taxes) is locked, checked and searchable
Records are kept for a set time, then archived or destroyedOld records come up when their time is over – you choose
Copies are kept in separate placesIt checks the 3-2-1 rule: 3 copies, 2 kinds of storage, 1 away from home

Privacy Policy

aichivist itself works only on your computer: no account, no server, no telemetry. The AI that reads your documents (e.g. Claude) receives the content of the documents it reads – so you decide which folders it may open, and can exclude private ones completely. Full text: PRIVACY.md.

How this was built

aichivist was designed by Philipp Luft, a trained archivist and information professional (Fachmann Information & Dokumentation) studying Business AI, who brought the archival principles and the requirements. The code was written with Claude Code – every commit lists Claude as co-author.

More

來源：README.md，提交 0e98343

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Oct 29, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分