Skip to main content Inicio Creadores hg-ha mtools mtools
mtools Use MTools desktop MCP for local image/audio/video processing, ASR/TTS, OCR, subtitle workflows, and developer utilities. Prefer when the user asks to compress/convert media, generate subtitles, remove watermarks, OCR images, translate text, or call local HTTP/WebSocket tools. Requires MTools app running with MCP enabled (default http://127.0.0.1:8765/mcp).
Ir a la instalación Skills Marketplace Descubre y explora habilidades de IA creadas por la comunidad.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Mostrar detalles del prompt Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.
npx skills add https://github.com/HG-ha/MTools --skill mtoolsEl comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.
¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.
Descargar Zip Descargando... Ocupaciones relacionadas SOC
Basado en la clasificación ocupacional SOC
Explorador de archivos
2 archivos name mtools description Use MTools desktop MCP for local image/audio/video processing, ASR/TTS, OCR, subtitle workflows, and developer utilities. Prefer when the user asks to compress/convert media, generate subtitles, remove watermarks, OCR images, translate text, or call local HTTP/WebSocket tools. Requires MTools app running with MCP enabled (default http://127.0.0.1:8765/mcp). version 1.0.0 license MIT platforms ["windows","macos","linux"] metadata {"openclaw":{"emoji":"🧰","requires":{"config":["mcp"]}},"hermes":{"tags":["MTools","MCP","Media","Image","Video","Audio","Subtitle","OCR","Local"]}}
MTools MCP
MTools is a local desktop toolbox. Its built-in MCP server exposes ~63 tools
(plus helpers). This skill teaches when and how to call them.
Prerequisites
User has MTools desktop app running
Settings → MCP 服务 → enabled
Default endpoint: http://127.0.0.1:8765/mcp
AI/ONNX features need models already downloaded inside MTools GUI If MCP is offline: tell the user to open MTools and enable MCP. Do not invent paths.
Call rules (strict)
Prefer atomic tools : mtools_image_compress, mtools_video_convert, …
Unknown params → mtools_help("image.compress") first
List capabilities → mtools_tool_ids() or mtools_help()
Fallback entry → mtools_run(tool_id, params_json)
Paths must be absolute local paths on the user's machine
Responses are JSON strings — check ok before continuing
Markdown viewer is not exposed via MCP
Quick map (user intent → tool) User says Call 压缩图片 mtools_image_compress图片转 jpg/png/webp mtools_image_format抠图 / 去背景 mtools_image_backgroundOCR / 识字 mtools_image_ocr去图片水印 mtools_image_watermark_remove压缩视频 mtools_video_compress视频转格式 mtools_video_convert视频提取音频 mtools_video_extract_audio视频去字幕 mtools_video_subtitle_remove视频生成字幕 mtools_video_subtitle（可 target_lang/bilingual/burn_in）TS 分片合并 mtools_video_ts_merge音频转文字 mtools_audio_to_text文字转语音 mtools_audio_text_to_speech人声分离 mtools_audio_vocal_extraction / mtools_video_vocal_separation字幕格式互转 mtools_subtitle_convertAI 润色字幕 mtools_ai_subtitle_fix翻译 mtools_others_translate证件照 mtools_others_id_photoHTTP 请求 mtools_dev_http_clientWebSocket mtools_websocket（connect→send→receive→disconnect）录屏 仅 GUI，MCP 不可用
Naming: tool_id image.compress → atomic tool mtools_image_compress
(mtools_ + dots → underscores).
Workflows
A. Compress a photo mtools_image_compress(
input_path="C:/photos/a.jpg",
quality="high", # high|medium|low
compress_mode_name="balanced" # fast|balanced|max
)
B. Video → subtitles (timestamps / translate / burn-in) mtools_video_subtitle(
input_path="C:/a.mp4",
language="zh",
target_lang="en", # optional translate
bilingual=True, # original + translation
burn_in=False # True = burn into video
)
Then optionally preserve timing with AI fix:
mtools_ai_subtitle_fix(
segments_json='[{"text":"...","start":0,"end":1.2}, ...]',
base_url=..., api_key=..., model=...
)
Need SenseVoice/Whisper model downloaded in MTools first.
C. Audio → text mtools_audio_to_text(input_path="C:/a.mp3", language="zh")
Default engine is SenseVoice (50+ languages) via sherpa-onnx.
D. Remove hardsubs / watermarks mtools_video_subtitle_remove(
input_path="C:/a.mp4",
left=0, top=800, right=1920, bottom=1080
)
Or band: subtitle_region="bottom"|"top". Needs subtitle-remove model in MTools.
E. Compress video with controls mtools_video_compress(input_path="C:/a.mp4", scale="720p", crf=23, fps=30)
F. WebSocket session 1. mtools_websocket(action="connect", url="ws://127.0.0.1:8080")
→ save 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=...)
Error handling Symptom What to do connection refused Ask user to start MTools + enable MCP ok: false + 模型未下载Ask user to download model in MTools GUI path not found Ask for a real absolute path ffmpeg unavailable Ask user to configure FFmpeg in MTools settings
Do / Don't
Do call mtools_status once when unsure if MCP is healthyDo keep output_path empty when auto output is fineDon't expose or log API keys from mtools_ai_subtitle_fixDon't claim screen recording works over MCPDon't call fat legacy tools (mtools_image with action=…) — use atomics
Install MCP client config See install.md for OpenClaw / Hermes / Cursor snippets.
