MTools MCP
MTools est une boîte à outils de bureau locale. Son serveur MCP intégré expose environ 63 outils (plus des aides). Ce skill enseigne quand et comment les appeler.
Prérequis
- L'utilisateur a l'application de bureau MTools en cours d'exécution
- Paramètres → MCP 服务 → activé
- Point de terminaison par défaut :
http://127.0.0.1:8765/mcp - Les fonctionnalités AI/ONNX nécessitent que les modèles soient déjà téléchargés via l'interface graphique de MTools
Si MCP est hors ligne : demandez à l'utilisateur d'ouvrir MTools et d'activer MCP. N'inventez pas de chemins.
Règles d'appel (strictes)
- Préférez les outils atomiques :
mtools_image_compress,mtools_video_convert, … - Paramètres inconnus → appelez
mtools_help("image.compress")d'abord - Liste des capacités →
mtools_tool_ids()oumtools_help() - Entrée de repli →
mtools_run(tool_id, params_json) - Les chemins doivent être des chemins locaux absolus sur la machine de l'utilisateur
- Les réponses sont des chaînes JSON — vérifiez
okavant de continuer - La visionneuse Markdown n'est pas exposée via MCP
Mappage rapide (intention utilisateur → outil)
| L'utilisateur dit | Appelez |
|---|---|
| Compresser une image | mtools_image_compress |
| Convertir une image en jpg/png/webp | mtools_image_format |
| Détourer / Supprimer l'arrière-plan | mtools_image_background |
| OCR / Lire du texte | mtools_image_ocr |
| Supprimer un filigrane d'image | mtools_image_watermark_remove |
| Compresser une vidéo | mtools_video_compress |
| Convertir un format vidéo | mtools_video_convert |
| Extraire l'audio d'une vidéo | mtools_video_extract_audio |
| Supprimer les sous-titres d'une vidéo | mtools_video_subtitle_remove |
| Générer des sous-titres pour une vidéo | mtools_video_subtitle (avec target_lang/bilingual/burn_in possibles) |
| Fusionner des segments TS | mtools_video_ts_merge |
| Transcrire l'audio en texte | mtools_audio_to_text |
| Synthèse vocale (texte en parole) | mtools_audio_text_to_speech |
| Séparation des voix | mtools_audio_vocal_extraction / mtools_video_vocal_separation |
| Convertir un format de sous-titres | mtools_subtitle_convert |
| Améliorer des sous-titres par IA | mtools_ai_subtitle_fix |
| Traduire | mtools_others_translate |
| Photo d'identité | mtools_others_id_photo |
| Requête HTTP | mtools_dev_http_client |
| WebSocket | mtools_websocket (connecter→envoyer→recevoir→déconnecter) |
| Capture d'écran | Uniquement via GUI, MCP non disponible |
Nommage : tool_id image.compress → outil atomique mtools_image_compress
(mtools_ + points → underscores).
Workflows
A. Compresser une photo
mtools_image_compress(
input_path="C:/photos/a.jpg",
quality="high", # high|medium|low
compress_mode_name="balanced" # fast|balanced|max
)
B. Vidéo → sous-titres (horodatage / traduction / incrustation)
mtools_video_subtitle(
input_path="C:/a.mp4",
language="zh",
target_lang="en", # traduction optionnelle
bilingual=True, # original + traduction
burn_in=False # True = incruster dans la vidéo
)
Ensuite, préservez éventuellement le timing avec une correction IA :
mtools_ai_subtitle_fix(
segments_json='[{"text":"...","start":0,"end":1.2}, ...]',
base_url=..., api_key=..., model=...
)
Nécessite un modèle SenseVoice/Whisper téléchargé dans MTools au préalable.
C. Audio → texte
mtools_audio_to_text(input_path="C:/a.mp3", language="zh")
Le moteur par défaut est SenseVoice (50+ langues) via sherpa-onnx.
D. Supprimer des sous-titres incrustés / filigranes
Préférez une région exacte :
mtools_video_subtitle_remove(
input_path="C:/a.mp4",
left=0, top=800, right=1920, bottom=1080
)
Ou une bande : subtitle_region="bottom"|"top". Nécessite un modèle de suppression de sous-titres dans MTools.
E. Compresser une vidéo avec contrôle
mtools_video_compress(input_path="C:/a.mp4", scale="720p", crf=23, fps=30)
F. Session WebSocket
1. mtools_websocket(action="connect", url="ws://127.0.0.1:8080")
→ sauvegarder 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=...)
Gestion des erreurs
| Symptôme | Que faire |
|---|---|
| Connexion refusée | Demander à l'utilisateur de démarrer MTools et d'activer MCP |
ok: false + modèle non téléchargé | Demander à l'utilisateur de télécharger le modèle dans l'interface graphique de MTools |
| Chemin introuvable | Demander un chemin absolu réel |
| ffmpeg indisponible | Demander à l'utilisateur de configurer FFmpeg dans les paramètres de MTools |
À faire / À ne pas faire
- Faites appeler
mtools_statusune fois si vous n'êtes pas sûr que MCP est opérationnel - Faites laisser
output_pathvide si une sortie automatique est acceptable - Ne faites pas exposer ou journaliser les clés API provenant de
mtools_ai_subtitle_fix - Ne faites pas prétendre que l'enregistrement d'écran fonctionne via MCP
- N'appelez pas les anciens outils "fat legacy" (
mtools_imageavec action=…) — utilisez les outils atomiques
Installer la configuration client MCP
Voir install.md pour des extraits pour OpenClaw / Hermes / Cursor.