Model Context Protocol
MCPサーバー
AI搭載のファイルリネーム、整理、PDF分割をClaude Code、Claude Desktop、Cursor、Windsurf、およびMCP互換クライアントに導入します。平易な日本語でファイルの命名方法をAIに指示できます—AIは実際のドキュメント内容を読み取り、指示に従います。
機能
- 自然言語プロンプト — 平易な言葉で命名ルールを記述(ドキュメントタイプ別ルール、条件付きロジック、ローカライゼーション)
- AIコンテンツ分析 — OCRとNLPがファイル内容から日付、ベンダー、金額、ドキュメントタイプ、参照番号を抽出
- PDF分割 — コンテンツ/トピック(AI)、ブックマーク、またはページ範囲でPDFを分割
- 整理戦略 — 年、会社、ドキュメントタイプ、または組み合わせでフォルダに自動ソート
- ドライランモード — 変更を確定する前にリネームをプレビュー
クイックスタート
1つのコマンドでClaude Codeに追加:
$ claude mcp add renamed-to -- npx -y @renamed-to/mcpAPIキーを設定すれば準備完了:
$ export RENAMED_API_KEY="rt_..."Claude Desktop、Cursor、またはWindsurfをお使いですか?MCP設定ファイルに追加:
{
"mcpServers": {
"renamed-to": {
"command": "npx",
"args": ["-y", "@renamed-to/mcp"],
"env": {
"RENAMED_API_KEY": "rt_your_key_here"
}
}
}
}認証
- サインアップ でrenamed.toアカウントを作成
- 設定 → APIキー でキーを作成
- MCP設定に環境変数を設定
サーバーはフォールバックとしてRENAMED_TOKENも受け付けます。statusツールを使用して接続を確認してください。
ツール
rename自然言語プロンプトによるAI搭載ファイルリネーム
filePathsoutputDir?format?dryRun?pdf_splitコンテンツ、ブックマーク、またはページ範囲でPDFを分割
filePathstrategy?outputDir?watchディレクトリを監視して新しいファイルを検出(CLIに委譲)
directoryoutputDir?status認証とAPI接続を確認
Rename
ファイルをrenamed.to APIに送信し、実際のドキュメント内容を読み取ります—スキャンにはOCR、テキストにはNLP—メタデータ(日付、ベンダー、金額、参照番号)を抽出し、指示に基づいてファイル名を生成します。
filePathsrequiredリネームするファイルの絶対パスまたは相対パス。
outputDirリネームされたファイルを書き込むディレクトリ。デフォルトはソースディレクトリ。
formatファイル名のフォーマット方法を説明する自然言語プロンプト。指定しない場合、AIは各ドキュメントに最適な命名パターンを自動的に選択します。
dryRunファイルを書き込まずにリネームをプレビュー。
プロンプト例
formatパラメータは平易な言葉の指示を受け付けます。AIはそれを解釈し、内容に基づいて各ファイルに適用します:
Invoices: {date} - {vendor} - Invoice #{number} - ${amount}
Contracts: {vendor} - {type} - {date}
Receipts: {date} - {vendor} - Receiptドキュメントタイプ別ルール、条件付きロジック、ローカライゼーションなどを指定できます:
- 部門プレフィックス —
"雇用関連ドキュメントにはHR_プレフィックス、財務記録にはFIN_プレフィックスを追加" - ローカライゼーション —
"ドイツの日付形式DD.MM.YYYYを使用、ドキュメントタイプをドイツ語に翻訳" - 条件付きロジック —
"請求金額が$1000を超える場合、LARGE_プレフィックスを追加" - 業界形式 —
"法的文書には案件番号を含め、会計には顧客コードを含める"
PDF Split
AIはドキュメント全体を読み取り、論理的なセクションとトピックの境界を識別し、それぞれに個別に命名されたPDFを作成します。
filePathrequired分割するPDFファイルのパス。
strategy分割戦略:ai(コンテンツを分析してトピックで分割)、bookmarks(PDFブックマーク境界で分割)、またはpages(ページ範囲で分割)。デフォルトはai。. Defaults to ai.
outputDir分割されたPDFファイルを書き込むディレクトリ。デフォルトはソースディレクトリ。
ツール注釈
| ツール | 読み取り専用 | 破壊的 | 冪等性 |
|---|---|---|---|
rename | いいえ | はい(ファイルを直接リネーム) | いいえ |
pdf_split | いいえ | いいえ(新しいファイルを作成) | はい |
watch | はい(情報のみ) | いいえ | はい |
status | はい | いいえ | はい |
使用例
"ダウンロードフォルダ内のすべてのPDFを内容に基づいてリネームして"
AIは各ファイルを読み取り—OCRでスキャン画像も—日付、ベンダー、ドキュメントタイプを抽出し、説明的な名前を生成します。
"これらのファイルをリネームして。請求書には'{date} - {vendor} - Invoice #{number}'形式、契約書には'{vendor} - {type} - {date}'形式を使用し、金額が$1000を超える場合はLARGE_プレフィックスを追加"
1つの平易なプロンプトから、条件付きロジックを含むドキュメントタイプ別の異なる命名ルールを適用します。
"この50ページの年次報告書をトピック別に個別のドキュメントに分割して"
コンテンツの境界を分析し、各論理セクションに個別に命名されたPDFを作成します—ブックマークは不要です。
"ドイツの日付形式DD.MM.YYYYを使用し、ドキュメントタイプをドイツ語に翻訳して、これらの請求書のドライランリネームを実行して"
ファイルを移動せずに新しいファイル名がどうなるかを表示します。AIが命名時のローカライゼーションと翻訳を処理します。
設定
Claude Code
$ claude mcp add renamed-to -- npx -y @renamed-to/mcpClaude Desktop
claude_desktop_config.jsonに追加:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Cursor
同じJSON形式を使用してMCP設定に追加(設定 → MCPサーバー)。
Windsurf
同じJSON形式を使用してMCP設定に追加。
エラー処理
| エラー | 原因 | 解決方法 |
|---|---|---|
| 未設定 | RENAMED_API_KEY RENAMED_API_KEYが設定されていない | 環境にAPIキーを追加、 (こちらで取得) |
| 認証失敗 | 無効または期限切れのAPIキー | で新しいキーを生成 (設定 → APIキー) |
| クレジット不足 | アカウントクレジットが枯渇 | でチャージ (設定 → 請求) |
| レート制限超過 | リクエストが多すぎる | 待ってから再試行 |
| ネットワークエラー | APIに到達できない | インターネット接続を確認 |
| ファイルが見つからない | 無効なファイルパス | パスが存在しアクセス可能か確認 |
セキュリティ
- APIキー は環境変数からのみ読み取られ、ハードコードやログ出力されません
- ファイル内容 は分析のためにrenamed.to APIに送信されます—機密ドキュメントを処理する際はご注意ください
- ローカル実行 stdioトランスポート経由—マシン上でネットワークポートは開きません
- データ保存なし サーバーはリクエスト間でステートレスです
要件
Node.js 20以降。サーバーはnpx経由で自動的にインストールされます—手動インストールは不要です。