ChangeThisFile

Conversão gratuita de arquivos entre 999 rotas (imagens, vídeo, áudio, documentos, dados, fontes, ebooks, arquivos) — sem necessidade de chave de API.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP ChangeThisFile

Use as sete ferramentas de arquivo do ChangeThisFile a partir de qualquer cliente MCP: conversão em mais de 1.000 rotas suportadas, tradução de documentos, extração de tabelas, compressão com tamanho exato, roteamento em linguagem natural e verificação de status de trabalhos.

Desenvolvido por ChangeThisFile.com. Trabalhos de descoberta e pré-visualização paga são públicos. O convert_file geral aceita uma chave de desenvolvedor verificada agora e compartilha sua cota com o uso da API REST. A conversão anônima permanece disponível durante a janela de compatibilidade do conector; a autenticação não será aplicada antes de 27 de agosto de 2026, e somente após a verificação do suporte do conector.

Ferramentas

Ferramenta	Descrição
`convert_file`	Converta um arquivo. Passe um `source_url` publicamente acessível ou `base64_content` (máx. ~5MB), além de um `target_format` (ex.: `pdf`, `mp3`, `json`). O formato de origem é detectado automaticamente a partir da URL/nome do arquivo, ou passe `source_format` explicitamente. Retorna uma URL de download válida por 1 hora.
`list_conversions`	Liste todas as rotas de conversão suportadas, opcionalmente filtradas por `source_format` (ex.: `docx` → veja todos os formatos para os quais você pode converter DOCX).
`translate_file`	Traduza um documento preservando seu layout. Retorna uma pré-visualização gratuita e um link de checkout único para a saída completa.
`extract_tables`	Extraia tabelas de PDFs ou imagens para Excel. Retorna uma pré-visualização gratuita e um link de checkout único para a saída completa.
`compress_file`	Comprima um PDF, imagem ou vídeo para um tamanho máximo exato. Gratuito com limite diário.
`do_file_job`	Roteie uma instrução de arquivo em linguagem natural para conversão, tradução, extração ou compressão.
`check_job`	Verifique um trabalho enviado e recupere sua pré-visualização, link de checkout ou URL de download.

Opção 1 — Endpoint remoto (recomendado, sem instalação)

O servidor está hospedado em https://changethisfile.com/mcp usando transporte HTTP streamable (especificação MCP 2025-03-26). Se o seu cliente suporta servidores MCP remotos, aponte-o diretamente para o endpoint. Clientes que suportam cabeçalhos personalizados podem enviar Authorization: Bearer ctf_sk_... para usar medição autenticada de desenvolvedor.

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

Claude Code:

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

Opção 2 — Servidor stdio local (este pacote)

Para clientes que só falam stdio, este pacote faz a ponte stdio ↔ endpoint hospedado:

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

CTF_API_KEY é opcional: sem ele, você obtém 25 conversões gratuitas por mês por rede; depois disso, convert_file solicita uma chave. Obtenha uma chave gratuita verificada no painel do ChangeThisFile (ou POST https://changethisfile.com/v1/keys/free com {"email":"you@example.com"} e clique no e-mail de verificação); suas 25 conversões mensais são compartilhadas entre MCP e REST. Planos pagos começam em US$ 29/mês.

Ou clone e execute diretamente:

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

Opção 3 — Skill de Agente / plugin Claude Code

Este repositório também funciona como um Agent Skill e plugin Claude Code.

Qualquer agente com capacidade de skills (Claude Code, Codex CLI, Cursor, Gemini CLI, Copilot e outros):

npx skills add aadilr/changethisfile-mcp

Plugin Claude Code (inclui o servidor MCP + a skill):

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

A skill file-conversion prefere as ferramentas MCP quando conectada e, caso contrário, usa um script incluído (skills/file-conversion/scripts/convert.sh) que fala com o endpoint hospedado via HTTPS simples — sem necessidade de cliente MCP.

Opção 4 — Docker

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

Teste rápido

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

Formatos suportados

Categoria	Exemplos
Imagem	JPG, PNG, WebP, GIF, BMP, AVIF, ICO, SVG, TIFF, HEIC, PSD, RAW
Vídeo	MP4, WebM, MKV, AVI, MOV, 3GP, FLV, WMV
Áudio	MP3, WAV, FLAC, AAC, OGG, M4A, OPUS
Documento	PDF, DOCX, DOC, ODT, RTF, TXT, HTML, MD, PPT, PPTX
Dados	JSON, CSV, TSV, YAML, XML, TOML, XLSX, XLS
Fonte	TTF, OTF, WOFF, WOFF2
Ebook	EPUB, MOBI, AZW3, FB2, CBR, CBZ
Arquivo	ZIP, RAR, 7Z, TAR, TAR.GZ, TAR.BZ2, TAR.XZ

Use list_conversions para a tabela completa de rotas.

Variáveis de ambiente

Variável	Padrão	Finalidade
`CTF_API_KEY`	não definido	Chave opcional de desenvolvedor verificada encaminhada como token bearer; o valor nunca é registrado
`CTF_MCP_URL`	`https://changethisfile.com/mcp`	Substitui o endpoint upstream
`CHANGETHISFILE_MCP_URL`	não definido	Alias legado para `CTF_MCP_URL`

Privacidade e limites

Trabalhos de descoberta e pré-visualização paga não exigem conta. A conversão geral é temporariamente anônima no modo de compatibilidade; uma chave verificada permite medição compartilhada de desenvolvedor agora.
Os arquivos são processados no servidor e excluídos automaticamente em até 24 horas; as URLs de download expiram após 1 hora.
As entradas MCP são limitadas a 25 MB. O convert_file autenticado usa a taxa compartilhada de API/MCP e a cota mensal da conta do desenvolvedor; outras ferramentas caras mantêm limites de abuso por conta ou por IP.

Licença

MIT