Skip to main content
Glama
deenesjakoruzh
aadilr

ChangeThisFile MCP Server

by aadilr
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

ChangeThisFile MCP Server

모든 MCP 클라이언트에서 ChangeThisFile의 7가지 파일 도구를 사용하세요: 1,000개 이상의 지원 경로에 걸친 변환, 문서 번역, 표 추출, 정확한 크기 압축, 자연어 라우팅, 작업 상태 확인.

ChangeThisFile.com에서 제공합니다. 탐색 및 유료 미리보기 작업은 공개입니다. 일반 convert_file은 이제 검증된 개발자 키를 허용하며 REST API 사용량과 할당량을 공유합니다. 익명 변환은 커넥터 호환 기간 동안 계속 사용할 수 있습니다. 인증은 2026년 8월 27일 이전에는 요구되지 않으며, 커넥터 지원이 확인된 이후에만 요구됩니다.

도구

도구

설명

convert_file

파일을 변환합니다. 공개적으로 접근 가능한 source_url 또는 base64_content(최대 ~5MB)와 target_format(예: pdf, mp3, json)을 전달하세요. 소스 형식은 URL/파일명에서 자동 감지되며, source_format을 명시적으로 전달할 수도 있습니다. 1시간 동안 유효한 다운로드 URL을 반환합니다.

list_conversions

지원되는 모든 변환 경로를 나열합니다. 선택적으로 source_format(예: docx → DOCX에서 변환할 수 있는 모든 형식 보기)으로 필터링할 수 있습니다.

translate_file

레이아웃을 유지한 채 문서를 번역합니다. 무료 미리보기와 전체 출력물을 위한 일회성 체크아웃 링크를 반환합니다.

extract_tables

PDF 또는 이미지에서 표를 추출하여 Excel로 변환합니다. 무료 미리보기와 전체 출력물을 위한 일회성 체크아웃 링크를 반환합니다.

compress_file

PDF, 이미지 또는 비디오를 정확한 최대 크기로 압축합니다. 일일 한도 내에서 무료입니다.

do_file_job

자연어 파일 지시문을 변환, 번역, 추출 또는 압축으로 라우팅합니다.

check_job

제출된 작업을 확인하고 미리보기, 체크아웃 링크 또는 다운로드 URL을 가져옵니다.

Related MCP server: Omni File Converter MCP

옵션 1 — 원격 엔드포인트(권장, 설치 불필요)

서버는 streamable HTTP transport(MCP 사양 2025-03-26)를 사용하여 https://changethisfile.com/mcp에서 호스팅됩니다. 클라이언트가 원격 MCP 서버를 지원한다면 엔드포인트를 바로 지정하세요. 사용자 지정 헤더를 지원하는 클라이언트는 Authorization: Bearer ctf_sk_...를 전송하여 인증된 개발자 미터링을 사용할 수 있습니다.

{
  "mcpServers": {
    "changethisfile": {
      "type": "streamable-http",
      "url": "https://changethisfile.com/mcp"
    }
  }
}

Claude Code:

claude mcp add --transport http changethisfile https://changethisfile.com/mcp

옵션 2 — 로컬 stdio 서버(이 패키지)

stdio만 지원하는 클라이언트를 위해 이 패키지는 stdio ↔ 호스팅 엔드포인트를 연결합니다:

{
  "mcpServers": {
    "changethisfile": {
      "command": "npx",
      "args": ["-y", "github:aadilr/changethisfile-mcp"],
      "env": {
        "CTF_API_KEY": "ctf_sk_your_key_here"
      }
    }
  }
}

CTF_API_KEY는 선택 사항입니다. 키 없이도 네트워크당 월 25회 무료 변환을 사용할 수 있으며, 이후에는 convert_file이 키를 요청합니다. ChangeThisFile 대시보드에서 검증된 무료 키를 받으세요(또는 {"email":"you@example.com"}과 함께 POST https://changethisfile.com/v1/keys/free를 호출하고 인증 이메일을 클릭하세요). 월 25회 변환은 MCP와 REST에서 공유됩니다. 유료 요금제는 월 $29부터 시작합니다.

또는 클론하여 직접 실행하세요:

git clone https://github.com/aadilr/changethisfile-mcp.git
cd changethisfile-mcp
npm install
node index.js

옵션 3 — Agent Skill / Claude Code 플러그인

이 저장소는 Agent Skill 및 Claude Code 플러그인으로도 사용할 수 있습니다.

스킬을 지원하는 모든 에이전트(Claude Code, Codex CLI, Cursor, Gemini CLI, Copilot 등):

npx skills add aadilr/changethisfile-mcp

Claude Code 플러그인(MCP 서버 + 스킬 번들):

/plugin marketplace add aadilr/changethisfile-mcp
/plugin install changethisfile@changethisfile

file-conversion 스킬은 연결 시 MCP 도구를 우선 사용하며, 그 외에는 일반 HTTPS로 호스팅 엔드포인트와 통신하는 번들 스크립트(skills/file-conversion/scripts/convert.sh)로 대체됩니다 — MCP 클라이언트가 필요 없습니다.

옵션 4 — Docker

docker build -t changethisfile-mcp .
docker run -i --rm -e CTF_API_KEY changethisfile-mcp

빠른 테스트

curl -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

지원 형식

카테고리

예시

이미지

JPG, PNG, WebP, GIF, BMP, AVIF, ICO, SVG, TIFF, HEIC, PSD, RAW

비디오

MP4, WebM, MKV, AVI, MOV, 3GP, FLV, WMV

오디오

MP3, WAV, FLAC, AAC, OGG, M4A, OPUS

문서

PDF, DOCX, DOC, ODT, RTF, TXT, HTML, MD, PPT, PPTX

데이터

JSON, CSV, TSV, YAML, XML, TOML, XLSX, XLS

폰트

TTF, OTF, WOFF, WOFF2

전자책

EPUB, MOBI, AZW3, FB2, CBR, CBZ

아카이브

ZIP, RAR, 7Z, TAR, TAR.GZ, TAR.BZ2, TAR.XZ

전체 경로 표는 list_conversions을 사용하세요.

환경 변수

변수

기본값

용도

CTF_API_KEY

미설정

선택적 검증된 개발자 키로 bearer 토큰으로 전달됩니다. 값은 절대 기록되지 않습니다.

CTF_MCP_URL

https://changethisfile.com/mcp

업스트림 엔드포인트를 재정의합니다.

CHANGETHISFILE_MCP_URL

미설정

CTF_MCP_URL의 레거시 별칭입니다.

개인정보 보호 및 제한

  • 탐색 및 유료 미리보기 작업은 계정이 필요 없습니다. 일반 변환은 호환 모드에서 일시적으로 익명으로 제공됩니다. 검증된 키를 사용하면 지금 바로 공유 개발자 미터링을 사용할 수 있습니다.

  • 파일은 서버 측에서 처리되며 24시간 이내에 자동 삭제됩니다. 다운로드 URL은 1시간 후 만료됩니다.

  • MCP 입력은 25MB로 제한됩니다. 인증된 convert_file은 개발자 계정의 공유 API/MCP 레이트와 월별 할당량을 사용합니다. 기타 고비용 도구는 계정별 또는 IP별 남용 방지 한도가 유지됩니다.

라이선스

MIT

Available Tools

2 tools
convert_fileConvert FileAInspect

Convert a file from one format to another. Pass EITHER a publicly accessible URL (source_url) OR base64-encoded file contents (base64_content + source_format) — exactly one is required. Returns a temporary download URL (valid 1 hour; file deleted within 24 hours).

ParametersJSON Schema
NameRequiredDescriptionDefault
source_urlNoPublicly accessible URL of the file to convert (preferred for large files)
base64_contentNoBase64-encoded file content (for small files; max ~5MB)
source_formatNoSource format extension (e.g. "docx", "mp4"). Auto-detected from URL if omitted.
target_formatYesTarget format extension (e.g. "json", "mp3", "pdf"). Required.
filenameNoOptional filename hint for auto-detection (e.g. "document.docx")

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses key behavioral details: returns a temporary download URL (valid 1 hour) and that the file is deleted within 24 hours. These details are beyond what annotations provide (readOnlyHint=false, destructiveHint=false) and give the agent important lifecycle information. No contradiction with annotations exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise at 3 sentences, each serving a distinct purpose: stating the core action, specifying parameter rules, and detailing the return behavior. No extraneous information is included, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description adequately explains the return format (temporary URL with expiry) and data retention. It covers all input modalities and constraints. The presence of sibling tool name provides context. The description is complete for a conversion tool of moderate complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already describes all 5 parameters (100% coverage), setting baseline at 3. The description adds semantic value by explaining the mutual exclusivity of source_url and base64_content, specifying the ~5MB limit for base64, and noting that source_format can be auto-detected. This enhances the agent's understanding beyond the schema's per-parameter descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description begins with a clear verb-resource pair: 'Convert a file from one format to another.' This immediately identifies the tool's core function. It also distinguishes itself from the sibling tool 'list_conversions' by focusing on performing the conversion rather than listing available formats.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states the two mutually exclusive input methods (url vs base64) and clarifies that exactly one is required. It provides guidance on when to prefer each (URL for large files, base64 for small files) and mentions auto-detection of source format. However, it does not explicitly state when not to use this tool or compare it to alternatives beyond the sibling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_conversionsList Supported ConversionsA
Read-only
Inspect

List all supported conversion routes. Optionally filter by source format to see what you can convert FROM a specific format.

ParametersJSON Schema
NameRequiredDescriptionDefault
source_formatNoFilter by source format (e.g. "docx" returns all DOCX target options)

TDQS

A4.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, so the description need not restate safety. The description adds the filtering behavior, which is useful but not extensive behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences efficiently communicate the purpose and optional filter, with zero unnecessary words. Front-loaded with the main action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one optional parameter and no output schema, the description fully covers what the agent needs to know: what it lists and how to filter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with the parameter already described, but the description adds meaning by explaining the filter effect and providing an example ('docx' returns all DOCX target options), enhancing understandability.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'list' and resource 'supported conversion routes', and implicitly distinguishes from sibling 'convert_file' by indicating this tool provides options for conversion rather than performing the conversion.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It specifies when to use the tool (to list conversion routes, optionally filtered by source format) and gives a concrete example. However, it does not explicitly state when not to use it or mention alternatives beyond the sibling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updatesv1.0.0
    • First observedconvert_file
    • First observedlist_conversions
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4.3/5.0
Disambiguation5/5

The two tools have clearly distinct purposes: one performs file conversions, the other lists supported conversion routes. No overlap exists.

Naming Consistency5/5

Both tools follow a consistent verb_noun pattern (convert_file, list_conversions) using snake_case, making naming predictable.

Tool Count3/5

With only 2 tools, the server feels minimal for a file conversion service. While covering the core functionality, the low count suggests a thin surface.

Completeness3/5

The server covers basic conversion and format discovery, but lacks features like conversion history, batch processing, or progress tracking, leaving notable gaps.

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aadilr/changethisfile-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server