Model Context Protocol

MCP Server

AI 기반 파일 이름 변경, 구성 및 PDF 분할을 Claude Code, Claude Desktop, Cursor, Windsurf 및 모든 MCP 호환 클라이언트에 가져오십시오. 일반 영어를 사용하여 파일 이름을 지정하는 방법을 AI에 알려주십시오. 실제 문서 내용을 읽고 지침을 따릅니다.

기능

  • 자연어 프롬프트일반 영어로 명명 규칙을 설명하십시오(문서 유형별 규칙, 조건부 논리, 현지화)
  • AI 콘텐츠 분석OCR 및 NLP가 파일 내용에서 날짜, 공급업체, 금액, 문서 유형 및 참조 번호를 추출합니다
  • PDF 분할콘텐츠/주제(AI), 북마크 또는 페이지 범위로 PDF 분할
  • 구성 전략연도, 회사, 문서 유형 또는 조합별로 폴더에 자동 정렬
  • 드라이런 모드변경 사항을 커밋하기 전에 이름 변경 미리보기

빠른 시작

단일 명령으로 Claude Code에 추가하십시오.

Terminal
$ 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_ 접두사를 추가하십시오"

단일 일반 영어 프롬프트에서 조건부 논리를 사용하여 문서 유형마다 다른 명명 규칙을 적용합니다.

"이 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 Servers)에 추가하십시오.

Windsurf

동일한 JSON 형식을 사용하여 MCP 구성에 추가하십시오.

오류 처리

오류원인해결
구성되지 않음RENAMED_API_KEY RENAMED_API_KEY가 설정되지 않음환경에 API 키를 추가하십시오 (여기서 받기)
인증 실패잘못되었거나 만료된 API 키에서 새 키를 생성하십시오 (설정 → API 키)
크레딧 부족계정 크레딧 소진에서 충전하십시오 (설정 → 청구)
속도 제한 초과요청이 너무 많음기다렸다가 다시 시도하십시오
네트워크 오류API에 도달할 수 없음인터넷 연결을 확인하십시오
파일을 찾을 수 없음잘못된 파일 경로경로가 존재하고 액세스 가능한지 확인하십시오

보안

  • API 키 는 환경 변수에서만 읽습니다. 하드코딩되거나 로그되지 않습니다
  • 파일 내용 은 분석을 위해 renamed.to API로 전송됩니다. 민감한 문서를 처리할 때 이 점을 유의하십시오
  • 로컬에서 실행 stdio 전송을 통해 실행됩니다. 컴퓨터에서 네트워크 포트가 열리지 않습니다
  • 데이터가 저장되지 않음 서버는 요청 간에 상태를 유지하지 않습니다

요구 사항

Node.js 20 이상입니다. 서버는 npx를 통해 자동으로 설치됩니다. 수동 설치가 필요하지 않습니다.

리소스