Communitygithub.com

HG-ha/MTools

Utiliza el MCP de escritorio de MTools para procesamiento local de imágenes, audio y video, ASR/TTS, OCR, flujos de trabajo de subtítulos y utilidades para desarrolladores. Preferible cuando el usuario solicite comprimir o convertir medios, generar subtítulos, eliminar marcas de agua, aplicar OCR a imágenes, traducir texto o invocar herramientas HTTP/WebSocket locales.

¿Qué es MTools?

MTools MCP es un conjunto de herramientas de escritorio local que expone aproximadamente 63 herramientas a través de un servidor MCP integrado. Está diseñado para agentes de IA que necesitan procesar medios (imágenes, audio, video) de forma local, realizar tareas como OCR, ASR/TTS, eliminación de marcas de agua, generación de subtítulos y flujos de trabajo de traducción. También incluye utilidades para desarrolladores como cliente HTTP y WebSocket. La habilidad requiere que la aplicación de escritorio MTools esté ejecutándose con MCP habilitado (por defecto en http://127.0.0.1:8765/mcp). El agente debe priorizar herramientas atómicas (ej. mtools_image_compress) sobre las heredadas, y consultar mtools_help ante parámetros desconocidos. Responde con JSON que incluye un campo 'ok' para verificar el éxito de la operación. Es compatible con Claude Code, Cursor y otros clientes MCP, y requiere que ciertos modelos de IA/ONNX se descarguen previamente en la GUI de MTools.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

MTools MCP

MTools es un conjunto de herramientas de escritorio local. Su servidor MCP integrado expone ~63 herramientas (más asistentes). Esta habilidad enseña cuándo y cómo invocarlas.

Requisitos previos

  1. El usuario debe tener la aplicación de escritorio MTools ejecutándose
  2. En Ajustes → MCP 服务 → habilitado
  3. Punto de conexión predeterminado: http://127.0.0.1:8765/mcp
  4. Las funciones de IA/ONNX necesitan modelos ya descargados dentro de la GUI de MTools

Si MCP está desconectado: indique al usuario que abra MTools y habilite MCP. No invente rutas.

Reglas de invocación (estrictas)

  1. Prefiera herramientas atómicas: mtools_image_compress, mtools_video_convert, …
  2. Parámetros desconocidos → mtools_help("image.compress") primero
  3. Listar capacidades → mtools_tool_ids() o mtools_help()
  4. Invocación de respaldo → mtools_run(tool_id, params_json)
  5. Las rutas deben ser rutas locales absolutas en la máquina del usuario
  6. Las respuestas son cadenas JSON — verifique ok antes de continuar
  7. El visor de Markdown no está expuesto a través de MCP

Mapa rápido (intención del usuario → herramienta)

El usuario diceInvocar
Comprimir imagenmtools_image_compress
Convertir imagen a jpg/png/webpmtools_image_format
Recortar / quitar fondomtools_image_background
OCR / reconocer textomtools_image_ocr
Quitar marca de agua de imagenmtools_image_watermark_remove
Comprimir videomtools_video_compress
Convertir formato de videomtools_video_convert
Extraer audio de videomtools_video_extract_audio
Quitar subtítulos del videomtools_video_subtitle_remove
Generar subtítulos para videomtools_video_subtitle (puede incluir target_lang/bilingual/burn_in)
Fusionar segmentos TSmtools_video_ts_merge
Convertir audio a textomtools_audio_to_text
Convertir texto a vozmtools_audio_text_to_speech
Separar vozmtools_audio_vocal_extraction / mtools_video_vocal_separation
Convertir formato de subtítulosmtools_subtitle_convert
Corregir subtítulos con IAmtools_ai_subtitle_fix
Traducirmtools_others_translate
Foto para identificaciónmtools_others_id_photo
Solicitud HTTPmtools_dev_http_client
WebSocketmtools_websocket (conectar→enviar→recibir→desconectar)
Grabación de pantallaSolo GUI, MCP no disponible

Nomenclatura: tool_id image.compress → herramienta atómica mtools_image_compress (mtools_ + puntos a guiones bajos).

Flujos de trabajo

A. Comprimir una foto

mtools_image_compress(
  input_path="C:/fotos/a.jpg",
  quality="high",          # high|medium|low
  compress_mode_name="balanced"  # fast|balanced|max
)

B. Video → subtítulos (marcas de tiempo / traducir / incrustar)

mtools_video_subtitle(
  input_path="C:/a.mp4",
  language="zh",
  target_lang="en",   # opcional: traducir
  bilingual=True,     # original + traducción
  burn_in=False       # True = incrustar en el video
)

Luego, opcionalmente, preservar la sincronización con corrección por IA:

mtools_ai_subtitle_fix(
  segments_json='[{"text":"...","start":0,"end":1.2}, ...]',
  base_url=..., api_key=..., model=...
)

Requiere tener el modelo SenseVoice/Whisper descargado en MTools primero.

C. Audio → texto

mtools_audio_to_text(input_path="C:/a.mp3", language="zh")

El motor predeterminado es SenseVoice (más de 50 idiomas) mediante sherpa-onnx.

D. Quitar subtítulos incrustados / marcas de agua

Prefiera una región exacta:

mtools_video_subtitle_remove(
  input_path="C:/a.mp4",
  left=0, top=800, right=1920, bottom=1080
)

O una banda: subtitle_region="bottom"|"top". Necesita el modelo de eliminación de subtítulos en MTools.

E. Comprimir video con controles

mtools_video_compress(input_path="C:/a.mp4", scale="720p", crf=23, fps=30)

F. Sesión WebSocket

1. mtools_websocket(action="connect", url="ws://127.0.0.1:8080")
   → guardar 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=...)

Manejo de errores

SíntomaQué hacer
Conexión rechazadaSolicitar al usuario que inicie MTools y habilite MCP
ok: false + modelo no descargadoSolicitar al usuario que descargue el modelo en la GUI de MTools
Ruta no encontradaSolicitar una ruta absoluta real
ffmpeg no disponibleSolicitar al usuario que configure FFmpeg en los ajustes de MTools

Hacer / No hacer

  • Haga invocar mtools_status una vez si no está seguro de que MCP esté funcionando
  • Haga dejar output_path vacío cuando la salida automática sea suficiente
  • No exponga ni registre claves de API de mtools_ai_subtitle_fix
  • No afirme que la grabación de pantalla funciona a través de MCP
  • No invoque herramientas heredadas grandes (mtools_image con action=…) — use las atómicas

Instalar configuración del cliente MCP

Consulte install.md para fragmentos de OpenClaw / Hermes / Cursor.

Skills relacionados