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
- El usuario debe tener la aplicación de escritorio MTools ejecutándose
- En Ajustes → MCP 服务 → habilitado
- Punto de conexión predeterminado:
http://127.0.0.1:8765/mcp - 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)
- Prefiera herramientas atómicas:
mtools_image_compress,mtools_video_convert, … - Parámetros desconocidos →
mtools_help("image.compress")primero - Listar capacidades →
mtools_tool_ids()omtools_help() - Invocación de respaldo →
mtools_run(tool_id, params_json) - Las rutas deben ser rutas locales absolutas en la máquina del usuario
- Las respuestas son cadenas JSON — verifique
okantes de continuar - El visor de Markdown no está expuesto a través de MCP
Mapa rápido (intención del usuario → herramienta)
| El usuario dice | Invocar |
|---|---|
| Comprimir imagen | mtools_image_compress |
| Convertir imagen a jpg/png/webp | mtools_image_format |
| Recortar / quitar fondo | mtools_image_background |
| OCR / reconocer texto | mtools_image_ocr |
| Quitar marca de agua de imagen | mtools_image_watermark_remove |
| Comprimir video | mtools_video_compress |
| Convertir formato de video | mtools_video_convert |
| Extraer audio de video | mtools_video_extract_audio |
| Quitar subtítulos del video | mtools_video_subtitle_remove |
| Generar subtítulos para video | mtools_video_subtitle (puede incluir target_lang/bilingual/burn_in) |
| Fusionar segmentos TS | mtools_video_ts_merge |
| Convertir audio a texto | mtools_audio_to_text |
| Convertir texto a voz | mtools_audio_text_to_speech |
| Separar voz | mtools_audio_vocal_extraction / mtools_video_vocal_separation |
| Convertir formato de subtítulos | mtools_subtitle_convert |
| Corregir subtítulos con IA | mtools_ai_subtitle_fix |
| Traducir | mtools_others_translate |
| Foto para identificación | mtools_others_id_photo |
| Solicitud HTTP | mtools_dev_http_client |
| WebSocket | mtools_websocket (conectar→enviar→recibir→desconectar) |
| Grabación de pantalla | Solo 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íntoma | Qué hacer |
|---|---|
| Conexión rechazada | Solicitar al usuario que inicie MTools y habilite MCP |
ok: false + modelo no descargado | Solicitar al usuario que descargue el modelo en la GUI de MTools |
| Ruta no encontrada | Solicitar una ruta absoluta real |
| ffmpeg no disponible | Solicitar al usuario que configure FFmpeg en los ajustes de MTools |
Hacer / No hacer
- Haga invocar
mtools_statusuna vez si no está seguro de que MCP esté funcionando - Haga dejar
output_pathvací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_imagecon action=…) — use las atómicas
Instalar configuración del cliente MCP
Consulte install.md para fragmentos de OpenClaw / Hermes / Cursor.