内容
# 蒸馏 MCP 服务器
[](https://swift.org)
[](https://apple.com/macos)
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://glama.ai/mcp/servers/juergenkoller-software/distill-mcp)
**让 Claude、Cursor 或任何 MCP 客户端为您重命名文件 — 自动基于内容。**
这是官方的 [模型上下文协议](https://modelcontextprotocol.io) 桥接器，用于 [**蒸馏**](https://store.juergenkoller.software/en/apps/distill) — 一个本地 macOS 应用程序，使用 AI（Claude、OpenAI、Gemini、Ollama 或 Apple Intelligence）读取文件并重命名为描述性、一致的名称。不再有 `IMG_4521.jpg` 或 `Scan_003.pdf` — 而是 `250401 Invoice Telekom.pdf`。
> **您需要安装并运行蒸馏应用程序。** 此 MCP 服务器是一个 stdio→HTTP 桥接器 — 实际的文件分析发生在应用程序中。在 [store.juergenkoller.software/apps/distill](https://store.juergenkoller.software/en/apps/distill) 获取蒸馏。
---
## 您可以使用
> “Claude，查看 ~/Downloads 中的 47 个 PDF 文件，根据内容重命名它们，但首先显示建议。”
MCP 服务器公开了 **9 个工具**：
| 工具 | 功能 |
|---|---|
| `rename_files` | 使用 AI 分析文件内容并重命名为描述性名称 |
| `suggest_names` | 建议新名称而不重命名（预览模式） |
| `revert_rename` | 撤销之前的重命名 |
| `get_rename_history` | 显示重命名历史（时间戳、前后、使用的 AI 提供商） |
| `watch_folder` | 添加文件夹到自动监控（新文件在后台重命名） |
| `app_status` | 当前状态、AI 提供商、剩余积分、监控的文件夹 |
| `set_provider` | 切换 AI 提供商 — Claude、OpenAI GPT-4o、Gemini、Ollama（本地）、Apple Intelligence |
| `get_rules` | 显示命名规则（日期格式、大写、类别、自定义模板） |
| `set_rules` | 更新命名规则 |
蒸馏读取 PDF、图像（通过 OCR）、Office 文档、电子邮件、HTML、RTF 和媒体文件。它提取日期、类别、描述、发件人和金额 — 然后使用您的可配置规则构建文件名。
---
## 安装
### 先决条件
1. **macOS 14 (Sonoma) 或更高版本**
2. **蒸馏应用程序已安装并运行** — [在此处获取](https://store.juergenkoller.software/en/apps/distill) （免费，按需付费积分从 €1.99 / 100 次重命名开始）
3. **Swift 5.9+** （Xcode 15+），如果从源代码构建
### 从源代码构建
```bash
git clone https://github.com/juergenkoller-software/distill-mcp.git
cd distill-mcp
swift build -c release
# 二进制文件：.build/release/DistillMCP
```
### 预编译二进制文件
从 [Releases](https://github.com/juergenkoller-software/distill-mcp/releases) 获取最新的 `DistillMCP`。
---
## 配置
### Claude 桌面版
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"distill": {
"command": "/path/to/DistillMCP",
"env": {
"DISTILL_PORT": "22200",
"DISTILL_TOKEN": "your-token-here"
}
}
}
}
```
在 **蒸馏 → 设置 → API & MCP** 中查找 `DISTILL_TOKEN`。
### Claude 代码
```bash
claude mcp add distill /path/to/DistillMCP \
--env DISTILL_PORT=22200 \
--env DISTILL_TOKEN=your-token-here
```
### 光标 / 其他 MCP 客户端
相同的模式 — `DistillMCP` 是一个 stdio MCP 服务器，通过上述两个环境变量进行配置。
---
## 工作原理
```
┌────────────────┐ JSON-RPC stdio ┌────────────────┐ HTTP+Bearer ┌────────────────┐
│ Claude/Cursor │ ───────────────► │ DistillMCP │ ─────────────► │ 蒸馏应用程序 │
│ （MCP 客户端） │ ◄─────────────── │ （此仓库） │ ◄───────────── │ （端口 22200） │
└────────────────┘ └────────────────┘ └────────────────┘
```
桥接器从 `stdin` 读取 JSON-RPC 2.0 请求，将它们转发到蒸馏的本地 HTTP 服务器 `127.0.0.1:22200/mcp`，并将响应写回 `stdout`。所有 AI 调用（Claude/OpenAI/Gemini/Ollama/Apple Intelligence）、文件读取（OCR、PDF 提取、Office 解析）、信用跟踪和命名逻辑都在蒸馏应用程序中进行。
这种分割方式允许线格式保持开源（审计它、沙盒它、在任何 MCP 运行时运行它），而繁重的任务留在应用程序中。
---
## 环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
| `DISTILL_PORT` | `22200` | 蒸馏本地 HTTP 服务器的端口 |
| `DISTILL_TOKEN` | _(无)_ | 蒸馏设置中的 Bearer Token（必需） |
错误和跟踪日志会输出到 `stderr`，以便它们不会污染 JSON-RPC stdout 通道。
---
## 关于蒸馏
蒸馏是一款用于 macOS 的 AI 文件管理器，它根据内容分析自动重命名文件。亮点：
- **无订阅** — 免费应用程序，按需付费积分（100 次免费 / 100 次 €1.99 / 400 次 €4.99 / 1,000 次 €8.99）
- **五种 AI 提供商** — Claude、OpenAI GPT-4o、Google Gemini、Ollama（本地，无需 API）、Apple Intelligence
- **读取所有文件类型** — PDF、图像（OCR）、Office 文档、电子邮件、HTML、RTF、媒体文件
- **本地模式** 使用 Ollama — 不会离开您的 Mac
- **可配置的名称生成器** — 日期格式、大写、类别、自定义模板
- **文件夹监控** — 丢入文件，自动重命名
- **REST API + Swagger UI** — 用于非 MCP 自动化
- **MCP 服务器** （此仓库） — 用于 Claude/AI 代理
- **在 Mac 应用商店和直接下载可用**
→ **[在 store.juergenkoller.software 获取蒸馏](https://store.juergenkoller.software/en/apps/distill)**
---
## 许可证
MIT — 见 [LICENSE](LICENSE)。桥接器是开源的；蒸馏应用程序是商业的（免费试用，按需付费积分）。
## 问题和支持
- **桥接器错误：** [打开问题](https://github.com/juergenkoller-software/distill-mcp/issues)
- **应用程序支持：** [support@juergenkoller.software](mailto:support@juergenkoller.software)
由 [Juergen Koller 软件有限公司](https://juergenkoller.software) 构建。
