MTools MCP
O MTools é uma caixa de ferramentas local para desktop. Seu servidor MCP embutido expõe aproximadamente 63 ferramentas (além de auxiliares). Esta skill ensina quando e como chamá-las.
Pré-requisitos
- O usuário deve ter o aplicativo MTools desktop em execução
- Configurações → MCP 服务 → ativado
- Endpoint padrão:
http://127.0.0.1:8765/mcp - Recursos de IA/ONNX precisam de modelos já baixados na interface do MTools
Se o MCP estiver offline: informe ao usuário para abrir o MTools e ativar o MCP. Não invente caminhos.
Regras de chamada (rigorosas)
- Prefira ferramentas atômicas:
mtools_image_compress,mtools_video_convert, … - Parâmetros desconhecidos →
mtools_help("image.compress")primeiro - Listar capacidades →
mtools_tool_ids()oumtools_help() - Entrada de fallback →
mtools_run(tool_id, params_json) - Caminhos devem ser caminhos locais absolutos na máquina do usuário
- Respostas são strings JSON — verifique
okantes de continuar - O visualizador de Markdown não está exposto via MCP
Mapa rápido (intenção do usuário → ferramenta)
| Usuário diz | Chame |
|---|---|
| Comprimir imagem | mtools_image_compress |
| Converter imagem para jpg/png/webp | mtools_image_format |
| Remover fundo | mtools_image_background |
| OCR / Reconhecer texto | mtools_image_ocr |
| Remover marca d'água de imagem | mtools_image_watermark_remove |
| Comprimir vídeo | mtools_video_compress |
| Converter formato de vídeo | mtools_video_convert |
| Extrair áudio de vídeo | mtools_video_extract_audio |
| Remover legendas de vídeo | mtools_video_subtitle_remove |
| Gerar legendas para vídeo | mtools_video_subtitle (pode usar target_lang/bilingual/burn_in) |
| Mesclar segmentos TS | mtools_video_ts_merge |
| Áudio para texto | mtools_audio_to_text |
| Texto para fala | mtools_audio_text_to_speech |
| Separação vocal | mtools_audio_vocal_extraction / mtools_video_vocal_separation |
| Converter formato de legenda | mtools_subtitle_convert |
| Corrigir legenda com IA | mtools_ai_subtitle_fix |
| Traduzir | mtools_others_translate |
| Foto para documento | mtools_others_id_photo |
| Requisição HTTP | mtools_dev_http_client |
| WebSocket | mtools_websocket (conectar→enviar→receber→desconectar) |
| Gravação de tela | Apenas na GUI, MCP não disponível |
Nomenclatura: tool_id image.compress → ferramenta atômica mtools_image_compress
(mtools_ + pontos → sublinhados).
Fluxos de trabalho
A. Comprimir uma foto
mtools_image_compress(
input_path="C:/fotos/a.jpg",
quality="high", # high|medium|low
compress_mode_name="balanced" # fast|balanced|max
)
B. Vídeo → legendas (timestamps / traduzir / incorporar)
mtools_video_subtitle(
input_path="C:/a.mp4",
language="zh",
target_lang="en", # opcional: traduzir
bilingual=True, # original + tradução
burn_in=False # True = incorporar no vídeo
)
Em seguida, opcionalmente preservar o timing com correção por IA:
mtools_ai_subtitle_fix(
segments_json='[{"text":"...","start":0,"end":1.2}, ...]',
base_url=..., api_key=..., model=...
)
É necessário ter o modelo SenseVoice/Whisper baixado no MTools primeiro.
C. Áudio → texto
mtools_audio_to_text(input_path="C:/a.mp3", language="zh")
O mecanismo padrão é o SenseVoice (50+ idiomas) via sherpa-onnx.
D. Remover legendas fixas / marcas d'água
Prefira região exata:
mtools_video_subtitle_remove(
input_path="C:/a.mp4",
left=0, top=800, right=1920, bottom=1080
)
Ou faixa: subtitle_region="bottom"|"top". Necessita do modelo de remoção de legendas no MTools.
E. Comprimir vídeo com controles
mtools_video_compress(input_path="C:/a.mp4", scale="720p", crf=23, fps=30)
F. Sessão WebSocket
1. mtools_websocket(action="connect", url="ws://127.0.0.1:8080")
→ salvar session_id
2. mtools_websocket(action="send", session_id=..., message="ping")
3. mtools_websocket(action="receive", session_id=...)
4. mtools_websocket(action="disconnect", session_id=...)
Tratamento de erros
| Sintoma | O que fazer |
|---|---|
| conexão recusada | Peça ao usuário para iniciar o MTools e ativar o MCP |
ok: false + modelo não baixado | Peça ao usuário para baixar o modelo na interface do MTools |
| caminho não encontrado | Peça um caminho absoluto real |
| ffmpeg indisponível | Peça ao usuário para configurar o FFmpeg nas configurações do MTools |
Faça / Não faça
- Faça chame
mtools_statusuma vez se não tiver certeza se o MCP está saudável - Faça mantenha
output_pathvazio quando a saída automática for suficiente - Não faça exponha ou registre chaves de API de
mtools_ai_subtitle_fix - Não faça afirme que a gravação de tela funciona via MCP
- Não faça chame ferramentas legadas pesadas (
mtools_imagecom action=…) — use as atômicas
Instalar configuração do cliente MCP
Veja install.md para trechos para OpenClaw / Hermes / Cursor.