Communitygithub.com

HG-ha/MTools

Use o MCP de desktop do MTools para processamento local de imagens, áudio e vídeo, ASR/TTS, OCR, workflows de legendas e utilitários para desenvolvedores. Prefira quando o usuário pedir para comprimir/ converter mídia, gerar legendas, remover marcas d'água, OCR em imagens, traduzir texto ou chamar ferramentas HTTP/WebSocket locais. Requer o aplicativo MTools em execução com MCP ativado (padrão http://127.0.0.1:8765/mcp).

O que é MTools?

Esta skill integra o MTools, uma caixa de ferramentas local para desktop, ao ecossistema de agentes de IA como Claude Code, Cursor ou Codex. Ela expõe aproximadamente 63 ferramentas via seu servidor MCP (Model Context Protocol) embutido, permitindo que você execute tarefas como compressão de imagem e vídeo, conversão de formatos, remoção de fundo, OCR, remoção de marcas d'água, geração e tradução de legendas, reconhecimento de fala (ASR), síntese de voz (TTS), separação vocal e requisições HTTP/WebSocket diretamente do seu agente. A comunicação ocorre localmente via endpoint HTTP padrão (http://127.0.0.1:8765/mcp). A skill recomenda o uso de ferramentas atômicas (ex: `mtools_image_compress`) em vez de funções legadas, e fornece workflows prontos para tarefas comuns como comprimir fotos, extrair áudio de vídeos, remover legendas fixas ou realizar sessões WebSocket. O tratamento de erros orienta você a solicitar que o usuário inicie o MTools ou baixe modelos de IA quando necessário.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/HG-ha/MTools/tree/HEAD/skills/mtools

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. O usuário deve ter o aplicativo MTools desktop em execução
  2. Configurações → MCP 服务 → ativado
  3. Endpoint padrão: http://127.0.0.1:8765/mcp
  4. 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)

  1. Prefira ferramentas atômicas: mtools_image_compress, mtools_video_convert, …
  2. Parâmetros desconhecidos → mtools_help("image.compress") primeiro
  3. Listar capacidades → mtools_tool_ids() ou mtools_help()
  4. Entrada de fallback → mtools_run(tool_id, params_json)
  5. Caminhos devem ser caminhos locais absolutos na máquina do usuário
  6. Respostas são strings JSON — verifique ok antes de continuar
  7. O visualizador de Markdown não está exposto via MCP

Mapa rápido (intenção do usuário → ferramenta)

Usuário dizChame
Comprimir imagemmtools_image_compress
Converter imagem para jpg/png/webpmtools_image_format
Remover fundomtools_image_background
OCR / Reconhecer textomtools_image_ocr
Remover marca d'água de imagemmtools_image_watermark_remove
Comprimir vídeomtools_video_compress
Converter formato de vídeomtools_video_convert
Extrair áudio de vídeomtools_video_extract_audio
Remover legendas de vídeomtools_video_subtitle_remove
Gerar legendas para vídeomtools_video_subtitle (pode usar target_lang/bilingual/burn_in)
Mesclar segmentos TSmtools_video_ts_merge
Áudio para textomtools_audio_to_text
Texto para falamtools_audio_text_to_speech
Separação vocalmtools_audio_vocal_extraction / mtools_video_vocal_separation
Converter formato de legendamtools_subtitle_convert
Corrigir legenda com IAmtools_ai_subtitle_fix
Traduzirmtools_others_translate
Foto para documentomtools_others_id_photo
Requisição HTTPmtools_dev_http_client
WebSocketmtools_websocket (conectar→enviar→receber→desconectar)
Gravação de telaApenas 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

SintomaO que fazer
conexão recusadaPeça ao usuário para iniciar o MTools e ativar o MCP
ok: false + modelo não baixadoPeça ao usuário para baixar o modelo na interface do MTools
caminho não encontradoPeça um caminho absoluto real
ffmpeg indisponívelPeça ao usuário para configurar o FFmpeg nas configurações do MTools

Faça / Não faça

  • Faça chame mtools_status uma vez se não tiver certeza se o MCP está saudável
  • Faça mantenha output_path vazio 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_image com action=…) — use as atômicas

Instalar configuração do cliente MCP

Veja install.md para trechos para OpenClaw / Hermes / Cursor.

Habilidades Relacionadas