ChangeThisFile

Servidor MCP ChangeThisFile

Utiliza las siete herramientas de archivo de ChangeThisFile desde cualquier cliente MCP: conversión en más de 1,000 rutas compatibles, traducción de documentos, extracción de tablas, compresión de tamaño exacto, enrutamiento en lenguaje natural y verificación de estado de trabajos.

Desarrollado por ChangeThisFile.com. Los trabajos de descubrimiento y vista previa de pago son públicos. El convert_file general acepta una clave de desarrollador verificada ahora y comparte su cuota con el uso de la API REST. La conversión anónima sigue disponible durante la ventana de compatibilidad del conector; la autenticación no se aplicará antes del 27 de agosto de 2026, y solo después de que se verifique la compatibilidad del conector.

Herramientas

Herramienta	Descripción
convert_file	Convierte un archivo. Pasa una source_url de acceso público o base64_content (máx. ~5MB), además de un target_format (p. ej. pdf, mp3, json). El formato de origen se detecta automáticamente desde la URL/nombre de archivo, o pasa source_format explícitamente. Devuelve una URL de descarga válida por 1 hora.
list_conversions	Lista todas las rutas de conversión compatibles, opcionalmente filtradas por source_format (p. ej. docx → ve cada formato al que puedes convertir DOCX).
translate_file	Traduce un documento conservando su diseño. Devuelve una vista previa gratuita y un enlace de pago único para el resultado completo.
extract_tables	Extrae tablas de PDFs o imágenes a Excel. Devuelve una vista previa gratuita y un enlace de pago único para el resultado completo.
compress_file	Comprime un PDF, imagen o video a un tamaño máximo exacto. Gratis con un límite diario.
do_file_job	Enruta una instrucción de archivo en lenguaje natural a conversión, traducción, extracción o compresión.
check_job	Verifica un trabajo enviado y recupera su vista previa, enlace de pago o URL de descarga.

Opción 1 — Endpoint remoto (recomendado, sin instalación)

El servidor está alojado en https://changethisfile.com/mcp usando transporte HTTP transmisible (especificación MCP 2025-03-26). Si tu cliente admite servidores MCP remotos, apúntalo directamente al endpoint. Los clientes que admiten encabezados personalizados pueden enviar Authorization: Bearer ctf_sk_... para usar la medición autenticada de desarrollador.

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

Claude Code:

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

Opción 2 — Servidor stdio local (este paquete)

Para clientes que solo hablan stdio, este paquete conecta stdio ↔ al endpoint alojado:

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

CTF_API_KEY es opcional: sin él obtienes 25 conversiones gratuitas por mes por red; después de eso, convert_file solicita una clave. Obtén una clave gratuita verificada desde el panel de ChangeThisFile (o POST https://changethisfile.com/v1/keys/free con {"email":"you@example.com"} y haz clic en el correo de verificación); sus 25 conversiones mensuales se comparten entre MCP y REST. Los planes de pago comienzan en $29/mes.

O clona y ejecuta directamente:

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

Opción 3 — Habilidad de agente / plugin de Claude Code

Este repositorio funciona también como una Habilidad de agente y plugin de Claude Code.

Cualquier agente con capacidad de habilidades (Claude Code, Codex CLI, Cursor, Gemini CLI, Copilot y más):

npx skills add aadilr/changethisfile-mcp

Plugin de Claude Code (incluye el servidor MCP + la habilidad):

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

La habilidad file-conversion prefiere las herramientas MCP cuando está conectada y, de lo contrario, recurre a un script incluido (skills/file-conversion/scripts/convert.sh) que habla con el endpoint alojado a través de HTTPS simple — sin necesidad de cliente MCP.

Opción 4 — Docker

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

Prueba rápida

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

Formatos compatibles

Categoría	Ejemplos
Imagen	JPG, PNG, WebP, GIF, BMP, AVIF, ICO, SVG, TIFF, HEIC, PSD, RAW
Video	MP4, WebM, MKV, AVI, MOV, 3GP, FLV, WMV
Audio	MP3, WAV, FLAC, AAC, OGG, M4A, OPUS
Documento	PDF, DOCX, DOC, ODT, RTF, TXT, HTML, MD, PPT, PPTX
Datos	JSON, CSV, TSV, YAML, XML, TOML, XLSX, XLS
Fuente	TTF, OTF, WOFF, WOFF2
Libro electrónico	EPUB, MOBI, AZW3, FB2, CBR, CBZ
Archivo	ZIP, RAR, 7Z, TAR, TAR.GZ, TAR.BZ2, TAR.XZ

Usa list_conversions para la tabla completa de rutas.

Variables de entorno

Variable	Predeterminado	Propósito
CTF_API_KEY	sin definir	Clave opcional de desarrollador verificada enviada como token de portador; el valor nunca se registra
CTF_MCP_URL	https://changethisfile.com/mcp	Sobrescribe el endpoint ascendente
CHANGETHISFILE_MCP_URL	sin definir	Alias heredado para CTF_MCP_URL

Privacidad y límites

• Los trabajos de descubrimiento y vista previa de pago no requieren cuenta. La conversión general es temporalmente anónima en modo de compatibilidad; una clave verificada habilita la medición compartida de desarrollador ahora.
• Los archivos se procesan en el servidor y se eliminan automáticamente en 24 horas; las URL de descarga caducan después de 1 hora.
• Las entradas MCP están limitadas a 25 MB. El convert_file autenticado usa la tasa compartida de API/MCP y la cuota mensual de la cuenta de desarrollador; otras herramientas costosas conservan límites de abuso por cuenta o por IP.

Licencia

MIT