ドキュメント

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/mcp

APIキーを設定すれば準備完了:

$ export RENAMED_API_KEY="rt_..."

Claude Desktop、Cursor、またはWindsurfをお使いですか?MCP設定ファイルに追加:

claude_desktop_config.json
{
  "mcpServers": {
    "renamed-to": {
      "command": "npx",
      "args": ["-y", "@renamed-to/mcp"],
      "env": {
        "RENAMED_API_KEY": "rt_your_key_here"
      }
    }
  }
}

認証

  1. サインアップ でrenamed.toアカウントを作成
  2. 設定 → APIキー でキーを作成
  3. 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/mcp

Claude 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経由で自動的にインストールされます—手動インストールは不要です。

リソース