Distill Mcp

Distill MCP Server

Claude、Cursor、または任意の MCP クライアントに、ファイルの内容に基づいてファイル名を自動変更させることができます。

これは、Distill の公式 Model Context Protocol ブリッジです。Distill は、AI（Distill Cloud、ご自身の Claude、OpenAI、Gemini のアクセス、またはローカルの Ollama モデル）を使ってファイルを読み取り、わかりやすく一貫性のある名前に変更するネイティブ macOS アプリです。もう IMG_4521.jpg や Scan_003.pdf のままにせず、250401 Invoice Telekom.pdf のような名前を付けられます。

Distill アプリをインストールして起動しておく必要があります。 この MCP サーバーは stdio→HTTP ブリッジです。実際のファイル分析はアプリ内で行われます。Distill は store.juergenkoller.software/apps/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	マニュアルの1章を 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 に添付されているバイナリは、Glama などのコンテナベースの MCP レジストリ向けの静的な 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_API_TOKEN が必要なのは、Distill → Settings → API でトークンを設定した場合のみです。トークンを設定しない場合、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 サーバーで、上記 2 つの環境変数を使って設定します。

---

動作の仕組み

┌────────────────┐  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	(なし)	ベアラートークン。Distill → Settings → API で設定した場合のみ必要です
DISTILL_MANUAL_JSON	(バイナリの隣)	ソースからビルドしたブリッジで使用する distill-manual.json のパス：/Applications/Distill.app/Contents/Resources/distill-manual.json

エラーとトレースログは stderr に出力されるため、JSON-RPC の stdout チャネルが汚染されることはありません。

---

エラー

拒否された場合はすべて、エージェントが対処できる文を含む MCP エラー（isError: true）として返されます。

状況	ブリッジからの報告内容
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」シートで承認します。エージェントには実行できません
その他の 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 エージェント向けに利用可能
• 24 言語に対応
• Mac App Store と直接ダウンロードで提供 — REST API と MCP サーバーは直接ダウンロード版に付属します

→ store.juergenkoller.software から Distill を入手

---

ライセンス

MIT — 詳細は LICENSE をご覧ください。Bridge はオープンソースです。Distill アプリは商用製品です（従量課金制のクレジットで無料試用できます）。

問題とサポート

• Bridge のバグ： issue を作成
• アプリのサポート： [email protected]

Juergen Koller Software GmbH が開発しました。