Distill Mcp

Distill MCP 服务器

让 Claude、Cursor 或任何 MCP 客户端自动根据文件内容为你重命名文件。

这是 Distill 的官方 Model Context Protocol 桥接程序。Distill 是一款原生 macOS 应用，可使用 AI（Distill Cloud、你自己的 Claude、OpenAI 或 Gemini 访问权限，或本地 Ollama 模型）读取文件，并为文件设置描述性且一致的名称。不再需要 IMG_4521.jpg 或 Scan_003.pdf，改用 250401 Invoice Telekom.pdf。

你需要安装并运行 Distill 应用。 此 MCP 服务是一个 stdio→HTTP 桥接程序——实际的文件分析由应用完成。可在 store.juergenkoller.software/apps/distill 获取 Distill。

网站提供的 Distill 版本已包含此桥接程序 distill-mcp-server，以及离线手册。只有在想要审查或修改桥接程序时，才需要从此仓库构建。Mac App Store 版本既不包含 REST API，也不包含 MCP 服务。

---

你可以做什么

“Claude，查看 ~/Downloads 中的 47 个 PDF，根据内容重命名，但先给我看建议。”

MCP 服务提供 13 个工具：

工具	功能
rename_files	使用 AI 分析文件内容，并以描述性名称重命名
suggest_names	提供新名称建议，但不重命名（预览模式）
revert_rename	撤销之前的重命名
get_rename_history	显示重命名历史（时间戳、前后名称、使用的 AI 提供方）
watch_folder	将文件夹添加到自动监控中（新文件会在后台重命名）
process_existing_files	处理受监控文件夹中已有的文件
queue_status	自动处理进度：已检测、已完成、待处理、已重命名、失败
app_status	当前状态、AI 提供方、剩余额度、受监控文件夹
set_provider	切换 AI 提供方——Distill Cloud（默认，使用额度）；网站版本还支持你自己的 Claude、OpenAI 或 Gemini 访问权限，或 Ollama（本地）
get_rules	显示命名规则（日期格式、大小写、类别、自定义模板）
set_rules	更新命名规则
search_manual	搜索 Distill 用户手册（支持离线使用，即使应用未运行也可以）
get_manual_section	以 Markdown 格式读取手册中的一个章节

Distill 可读取 PDF、图像（通过 OCR）、Office 文档、电子邮件、HTML、RTF 和媒体文件。它会提取日期、类别、描述、发件人和金额，然后根据你配置的规则生成文件名。

---

安装

前置条件

1. macOS 15（Sequoia）或更高版本——Distill 的自身要求
2. 已安装并运行 Distill 应用——点击此处获取（网站版本；免费，提供 100 个入门额度，之后每 100 个名称建议收费 €1.99 起）
3. 在 Distill 窗口中接受使用条款和隐私政策——接受之前，API 只会响应状态请求
4. Swift 5.9+（Xcode 15+），仅在从源代码构建时需要

在应用内使用桥接程序（推荐）

/Applications/Distill.app/Contents/MacOS/distill-mcp-server

它始终与已安装的应用版本匹配，并会自动找到离线手册。

从源代码构建

git clone https://github.com/juergenkoller-software/distill-mcp.git
cd distill-mcp
swift build -c release
# Binary: .build/release/DistillMCP

预构建二进制文件

Mac 上无需使用：Distill 网站版已附带桥接程序（见上文）。Releases 中附带的二进制文件是面向基于容器的 MCP 注册表（如 Glama）的静态 Linux x86_64 构建版本，无法在 macOS 上运行。

---

配置

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "distill": {
      "command": "/Applications/Distill.app/Contents/MacOS/distill-mcp-server",
      "env": {
        "DISTILL_API_PORT": "43821",
        "DISTILL_API_TOKEN": "only-if-set-in-distill"
      }
    }
  }
}

仅当你在 Distill → Settings → API 中设置了令牌时，才需要 DISTILL_API_TOKEN。未设置令牌时，Distill 只接受来自你自己的 Mac 的连接。

Claude Code

claude mcp add distill /Applications/Distill.app/Contents/MacOS/distill-mcp-server \
  --env DISTILL_API_PORT=43821

Cursor / 其他 MCP 客户端

配置方式相同——DistillMCP 是一个 stdio MCP 服务，通过上述两个环境变量进行配置。

---

工作原理

┌────────────────┐  JSON-RPC stdio   ┌────────────────┐  HTTP+Bearer   ┌────────────────┐
│  Claude/Cursor │ ───────────────►  │  DistillMCP    │ ─────────────► │  Distill.app   │
│  (MCP client)  │ ◄───────────────  │   (this repo)  │ ◄───────────── │  (port 43821)  │
└────────────────┘                   └────────────────┘                └────────────────┘

桥接程序从 stdin 读取 JSON-RPC 2.0 请求，将每次工具调用转换为对 Distill 本地 REST API（http://localhost:43821/v1/…）的请求，并将响应写回 stdout。所有 AI 调用（Distill Cloud、Claude、OpenAI、Gemini、Ollama）、文件读取（OCR、PDF 提取、Office 解析）、额度跟踪和命名逻辑都在 Distill 应用内完成。

这种拆分让线路格式保持开源（可以审计、沙箱隔离，或通过任意 MCP 运行时运行），同时将繁重工作留在应用内完成。

---

环境变量

变量	默认值	描述
DISTILL_API_PORT	43821	Distill 本地 HTTP 服务的端口（Distill → Settings → API）
DISTILL_API_TOKEN	(none)	Bearer 令牌——仅在 Distill → Settings → API 中设置时需要
DISTILL_MANUAL_JSON	(next to the binary)	为从源代码构建的桥接程序指定 distill-manual.json 的路径：/Applications/Distill.app/Contents/Resources/distill-manual.json

错误和跟踪日志会写入 stderr，以免污染 JSON-RPC 的 stdout 通道。

---

错误

每次拒绝都会以 MCP 错误（isError: true）的形式返回，并附带 Agent 可据以采取行动的说明：

情况	桥接程序报告的内容
Distill 未运行、API 已关闭，或使用了 Mac App Store 版本	无法通过 http://localhost:<port> 访问 Distill；请打开 Distill 并检查 Settings → API
令牌错误或缺失（HTTP 401）	将 DISTILL_API_TOKEN 设置为 Distill → Settings → API 中的令牌
尚未接受法律文本（HTTP 403 legal_not_accepted）	用户打开 Distill 窗口，并在“Legal Notice”面板中接受；Agent 无法代为操作
任何其他 HTTP 错误	状态码和 Distill 的错误文本，例如应用启动期间出现的 engine not ready

在 0.2.0 之前的版本中，桥接程序会忽略 HTTP 状态，因此这些拒绝看起来像是调用成功。

---

关于 Distill

Distill 是一款适用于 macOS 的 AI 文件管理器，可根据内容分析自动重命名文件。主要特点：

• 无需订阅 — 免费应用，按使用量购买点数（100 点免费 / 100 点 €1.99 / 400 点 €4.99 / 1,000 点 €8.99）
• 默认使用 Distill Cloud — 使用点数，无需注册；在网站版中，还可使用你自己的 Claude、OpenAI 或 Google Gemini 访问权限（不消耗点数），或使用 Ollama（本地运行，无需 API 密钥）
• 可读取各种文件 — PDF、图像（OCR）、Office 文档、电子邮件、HTML、RTF、媒体文件
• 仅本地模式，使用 Ollama — 数据不会离开你的 Mac
• 可配置的 NameBuilder — 日期格式、大小写、类别、自定义模板
• 文件夹监控 — 放入文件，即可自动重命名
• REST API + Swagger UI — 用于非 MCP 自动化
• MCP 服务（本仓库）— 供 Claude/AI Agent 使用，适用于网站版
• 支持 24 种语言
• 可在 Mac App Store 获取，也可直接下载 — REST API 和 MCP 服务随直接下载版一并提供

→ 在 store.juergenkoller.software 获取 Distill

---

许可证

MIT — 详见 LICENSE。Bridge 为开源项目；Distill 应用为商业软件（可免费试用，之后按使用量购买点数）。

问题与支持

• Bridge 错误：提交问题
• 应用支持：[email protected]

由 Juergen Koller Software GmbH 开发。